npm package: @mcpware/logoloom
Description: AI-powered logo design → SVG → full brand kit export. Free, local, MCP-native.
Author: ithiria894
Latest version: 1.0.1

# LogoLoom

**AI-powered logo design → SVG → full brand kit.** Free, local, MCP-native.

[![npm](https://img.shields.io/npm/v/@mcpware/logoloom)](https://www.npmjs.com/package/@mcpware/logoloom)
[![license](https://img.shields.io/npm/l/@mcpware/logoloom)](LICENSE)

## What it does

1. **AI designs your logo** — Claude reads your codebase, understands your brand, writes SVG
2. **Text → Path** — converts `<text>` to `<path>` so fonts render everywhere (opentype.js)
3. **Optimize** — cleans SVG, removes bloat, compresses paths (SVGO)
4. **Export brand kit** — PNG (256/512/1024), ICO favicon, WebP, OG image, color variants, brand guidelines

One command. Zero API cost. Everything runs locally.

## Quick Start

```bash
npx @mcpware/logoloom
```

### Claude Code / Cursor `.mcp.json`

```json
{
  "mcpServers": {
    "logoloom": {
      "command": "npx",
      "args": ["-y", "@mcpware/logoloom"]
    }
  }
}
```

Then ask Claude: **"Design a logo for my project"**

## Tools

| Tool | What it does |
|------|-------------|
| `text_to_path` | Convert SVG `<text>` elements to `<path>` using font outlines. Font-independent rendering. |
| `optimize_svg` | Clean and compress SVG (30-60% smaller). Remove metadata, merge paths. |
| `export_brand_kit` | Export full brand kit: PNG sizes, ICO, WebP, OG image, mono variants, BRAND.md. |
| `image_to_svg` | Convert PNG/JPG to SVG vector (vtracer). Best for logos and flat graphics. |

## Example Output

```
brand/
├── logo-full-light.svg      # Primary logo
├── logo-full-dark.svg       # Dark mode variant
├── icon-light.svg           # Icon only
├── icon-mono-black.svg      # Single-color (print)
├── icon-mono-white.svg      # White on dark
├── icon-256.png             # Small
├── icon-512.png             # Medium
├── icon-1024.png            # Large (app stores)
├── icon-512.webp            # Web optimized
├── favicon.ico              # Browser favicon
├── favicon-16.png           # 16px favicon
├── favicon-48.png           # 48px favicon
├── og-image.png             # Social share (1200×630)
└── BRAND.md                 # Colors, typography, usage rules
```

## How it works

```
You: "Design a logo for mcpware"

Claude:
  1. Reads your README + package.json
  2. Asks brand questions (audience, feel, color)
  3. Generates 6-8 SVG concepts in HTML preview
  4. You pick → Claude iterates → you approve

LogoLoom MCP:
  5. text_to_path → font-independent SVG
  6. optimize_svg → clean, compressed
  7. export_brand_kit → all sizes, all formats, brand guidelines

Output: brand/ folder, ready to use everywhere
```

## Why not just use Recraft / SVGMaker?

| | LogoLoom | Recraft V3 | SVGMaker |
|---|:---:|:---:|:---:|
| Price | **Free** | Free (no commercial) / $10/mo | $8+ |
| Commercial use | **Yes** | Paid only | Yes |
| Runs locally | **Yes** | No (cloud) | No (cloud) |
| MCP native | **Yes** | No | Yes |
| Full brand kit | **Yes** | No (SVG only) | No |
| Codebase-aware | **Yes** | No | No |

## Tech Stack

All open source, all running locally:

- **opentype.js** — font parsing, text → SVG path conversion
- **SVGO** — SVG optimization and compression
- **sharp** — SVG → PNG/WebP/ICO rasterization
- **vtracer** — bitmap → SVG vectorization (optional, needs system install)

## Requirements

- Node.js 18+
- For `image_to_svg`: install [vtracer](https://github.com/niccokunzmann/vtracer) (`cargo install vtracer`) or [potrace](https://potrace.sourceforge.net/) (`apt install potrace`)

## More from @mcpware

| Tool | What it does | Install |
|------|-------------|---------|
| [instagram-mcp](https://github.com/mcpware/instagram-mcp) | 23 Instagram Graph API tools | `npx @mcpware/instagram-mcp` |
| [claude-code-organizer](https://github.com/mcpware/claude-code-organizer) | Visual dashboard for Claude Code configs | `npx @mcpware/claude-code-organizer` |
| [ui-annotator-mcp](https://github.com/mcpware/ui-annotator-mcp) | Hover labels on any web page for AI | `npx @mcpware/ui-annotator-mcp` |
| [pagecast](https://github.com/mcpware/pagecast) | Record browser sessions as GIF/video | `npx @mcpware/pagecast` |

## License

MIT