# MCP Icon Generator

An MCP (Model Context Protocol) server that provides tools for generating app icons with custom text, colors, and sizes.

## Installation

Clone this repository:

```bash
git clone https://github.com/chacebot/mcp-icon-generator.git
cd mcp-icon-generator
npm install
```

For PNG generation (recommended), install Sharp:

```bash
npm install sharp
```

## Features

This server provides the following tools for icon generation:

- **generate_app_icon** - Generate a single app icon image with custom text and colors
- **generate_ios_app_icon_set** - Generate a complete iOS AppIcon.appiconset with all required sizes

## Quick Start

1. **Install dependencies:**
   ```bash
   npm install
   npm install sharp  # Optional but recommended for PNG generation
   ```

2. **Configure your MCP client** (Claude Desktop, Cursor, etc.):
   ```json
   {
     "mcpServers": {
       "icon-generator": {
         "command": "node",
         "args": ["/path/to/mcp-icon-generator/src/index.js"]
       }
     }
   }
   ```

## Tools

### generate_app_icon

Generate a single app icon image with customizable properties.

**Parameters:**
- `text` (required): Text to display on the icon (e.g., "K" for Kanban)
- `outputPath` (required): Full path where the icon PNG file should be saved
- `size` (optional): Icon size in pixels (default: 1024)
- `backgroundColor` (optional): Background color in hex format (default: "#FFFFFF")
- `textColor` (optional): Text color in hex format (default: "#000000")
- `fontSize` (optional): Font size as a percentage of icon size, 0.0-1.0 (default: 0.7)
- `fontFamily` (optional): Font family name (uses system default if not specified)

**Example:**
```json
{
  "text": "K",
  "outputPath": "/path/to/icon.png",
  "size": 1024,
  "backgroundColor": "#FFFFFF",
  "textColor": "#000000",
  "fontSize": 0.7
}
```

### generate_ios_app_icon_set

Generate a complete iOS AppIcon.appiconset directory with all required icon sizes and Contents.json.

**Parameters:**
- `text` (required): Text to display on the icon
- `appiconsetPath` (required): Path to the AppIcon.appiconset directory
- `backgroundColor` (optional): Background color in hex format (default: "#FFFFFF")
- `textColor` (optional): Text color in hex format (default: "#000000")
- `fontSize` (optional): Font size as a percentage (default: 0.7)

**Example:**
```json
{
  "text": "K",
  "appiconsetPath": "/path/to/AppIcon.appiconset",
  "backgroundColor": "#FFFFFF",
  "textColor": "#000000"
}
```

## Output Formats

- **With Sharp installed**: Generates PNG files directly
- **Without Sharp**: Generates SVG files (can be converted to PNG with external tools)

## Use Cases

- Generate app icons for iOS/Android apps
- Create placeholder icons during development
- Generate branded icons with custom text
- Batch generate icons for multiple apps

## License

MIT