icon-mcp-server

中文名称：图标生成 MCP 服务 English name：icon-mcp-server 分类 / Category：开发者工具 / Developer Tools · 图像生成 / Image Generation

A Model Context Protocol (MCP) server that generates software / app icons locally with Pillow — no external API, no network calls, no keys required.

一个基于 Pillow 的本地 MCP 服务，用于生成软件 / 应用图标（PNG / ICO / ICNS）。 无需外部 API、无需联网、无需密钥。

Renders PNG / ICO / ICNS files with gradients, shapes, borders, drop shadows, and centered text or emoji — perfect for quickly bootstrapping app icons, favicons, tray icons, or placeholder assets.

服务配置 / MCP Configuration

推荐使用 uvx 拉起（无需预装，自动创建临时环境）：

{
  "mcpServers": {
    "icon-generator": {
      "command": "uvx",
      "args": ["icon-mcp-server"]
    }
  }
}

环境变量 / Environment variables：无需（本服务完全离线运行，不依赖任何 API Key）。

托管部署兼容性 / Hosted deployment：

• 完全支持魔搭 MCP 广场「可托管部署」模式（Hosted / SSE）。

• 在托管模式下，generate_icon 和 generate_icon_set 会写入服务器磁盘，用户无法直接下载文件。

• 托管模式推荐使用 generate_icon_base64 工具，它直接返回 base64 编码的 PNG（客户端可渲染 data:image/png;base64,... URL）。

• 本地部署（stdio）时，全部 4 个工具都能正常使用。

Related MCP server: Toolkits MCP

工具列表 / Tools

Features / 特性

• 5 visual styles: gradient, solid, outlined, shape, mono

• 6 silhouette shapes: circle, square, rounded, triangle, hexagon, diamond

• Multi-resolution output: single PNG, full PNG set, or aggregated Windows .ico

• Optional .icns for macOS bundles

• 4× supersampling + LANCZOS downscale → crisp results even at 16 px

• Base64 preview mode for MCP clients that cannot read local files

• Zero external services — everything runs offline via Pillow

Install from PyPI / 安装

pip install icon-mcp-server

Or run without installing / 或免安装运行：

pipx run icon-mcp-server

Alternative MCP client configurations / 其他客户端配置

以下配置与顶部「服务配置」章节等效，供不同客户端场景选择。如果你正在把本服务提交给魔搭 MCP 广场，请使用顶部的 uvx 配置。

已 pip install 后（console script 在 PATH 上）

{
  "mcpServers": {
    "icon-generator": {
      "command": "icon-mcp-server",
      "args": []
    }
  }
}

通过 Python 模块方式（console script 不在 PATH 上时）

{
  "mcpServers": {
    "icon-generator": {
      "command": "python",
      "args": ["-m", "icon_mcp_server"]
    }
  }
}

Exposed MCP tools — parameters / 工具参数详情

Common parameters

Example calls

// generate_icon
{
  "out_path": "./out/app.png",
  "text": "Q",
  "style": "gradient",
  "shape": "rounded",
  "bg_color": "#4F8DFD",
  "bg_color_2": "#8E5BFF",
  "gradient_angle": 135,
  "size": 512
}

// generate_icon_set  → writes app_16.png … app_512.png + app.ico
{
  "out_dir": "./dist/icons",
  "base_name": "app",
  "text": "A",
  "style": "solid",
  "shape": "circle",
  "bg_color": "#FF7043",
  "include_ico": true,
  "png_sizes": [16, 32, 48, 64, 128, 256, 512]
}

Local development

git clone <your-fork-url> icon-mcp-server
cd icon-mcp-server
python -m venv .venv
# Windows PowerShell:
.venv\Scripts\Activate.ps1
# macOS / Linux:
# source .venv/bin/activate

pip install -e ".[dev]"
icon-mcp-server --self-test          # renders samples into ./_icon_self_test
python -m icon_mcp_server --version

Publishing to PyPI

One-time setup:

pip install --upgrade build twine

Build & upload:

# 1. Bump version in pyproject.toml (and src/icon_mcp_server/__init__.py)
# 2. Clean previous artifacts
rmdir /s /q dist 2>nul || rm -rf dist

# 3. Build sdist + wheel
python -m build

# 4. Validate
twine check dist/*

# 5. Upload to TestPyPI first (recommended)
twine upload --repository testpypi dist/*

# 6. Smoke-test install from TestPyPI
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ icon-mcp-server
icon-mcp-server --self-test

# 7. Publish to real PyPI
twine upload dist/*

Auth options for twine

• API token (recommended): set TWINE_USERNAME=__token__ and TWINE_PASSWORD=<your-pypi-token>, or configure ~/.pypirc:

  [distutils]
  index-servers = pypi, testpypi
  
  [pypi]
  username = __token__
  password = pypi-xxxxxxxxxxxxxxxxxxxxxxxx
  
  [testpypi]
  repository = https://test.pypi.org/legacy/
  username = __token__
  password = pypi-xxxxxxxxxxxxxxxxxxxxxxxx

• Trusted Publisher (OIDC) — no token needed. Configure it in the PyPI project settings and publish from a GitHub Actions workflow using pypa/gh-action-pypi-publish.

License

MIT — see LICENSE.