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

Install dependencies:

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

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: ``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

MCP Icon Generator