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:

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

For PNG generation (recommended), install Sharp:

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:

   npm install
   npm install sharp  # Optional but recommended for PNG generation
   

2. Configure your MCP client (Claude Desktop, Cursor, etc.):

   {
     "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:

{
  "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:

{
  "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