Icon MCP

icon-mcp

mcp-name: io.github.pratham-jain33/icon-mcp

あらゆる AI アシスタントに、カスタムアイコンボタンを追加できます。絵文字もデザイナーも必要ありません。

非公式のコミュニティプロジェクトです。 Lucide が作成、推奨、または提携しているものではありません。Lucide のアイコンセット（ISC ライセンス）がパッケージに同梱されているため、すべてオフラインで動作します。

理由

UI にアイコンが必要なとき、AI アシスタントは絵文字を使いがちです。良いアイコンを描くには、実際のデザイン作業が必要だからです。このサーバーを MCP 対応のアシスタント（Claude Desktop、Claude Code、Cursor など）に接続すると、キーワードで 2000 個以上の Lucide アイコンを検索し、スタイル（線の太さ、色、サイズ）を変更できます。また、1 回の呼び出しで統一感のあるアイコン一式を生成できるため、ページ上のすべてのアイコンに一体感が生まれます。SVG はマークアップとして返され、アシスタントがプロジェクトに直接保存します。API キーもアカウントもネットワーク接続も必要ありません。

ツール

ツール	説明
search_icons	名前とタグからキーワードでアイコンを検索します。正確なアイコン名がわからない場合に使います。
generate_icons	1 つのアイコン、または統一感のあるアイコン一式を、スタイル設定済みの SVG マークアップとして生成します。名前または平易な言葉でのクエリと、共通の stroke_width、color、size を指定します。

クイックスタート

インストール

クローンは不要です：

uvx icon-mcp

または pip を使用します：

pip install icon-mcp

代わりにソースからインストールする場合：

git clone https://github.com/pratham-jain33/icon-mcp
cd icon-mcp
python -m venv .venv
.venv/bin/pip install -e .

アシスタントを接続する

Claude Desktop の設定ファイル：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

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

環境変数もキーも不要です。ソースから実行する場合は、代わりにチェックアウト先を指定します：

{
  "mcpServers": {
    "icon-mcp": {
      "command": "/absolute/path/to/icon-mcp/.venv/bin/python",
      "args": ["-m", "icon_mcp.server"]
    }
  }
}

Claude Desktop を再起動して、次のように試してください：「設定アイコンとゴミ箱アイコンを、どちらも線の太さ 1.5px、色 #2f6bff、サイズ 32px の SVG で探してください。」

設定

設定は不要です。API キー、アカウント、ネットワークアクセスなど、設定するものはありません。アイコンセットはパッケージに同梱されています。

仕組み

1. アシスタントに、平易な言葉でアイコンをリクエストします。
2. アシスタントは search_icons を呼び出して適切な名前を探すか、キーワードをそのまま generate_icons に渡します。
3. サーバーは各クエリを同梱された Lucide SVG に対応付け、width、height、stroke-width、stroke の 4 つの属性を書き換えます。純粋な XML 操作であり、レンダリングもネイティブ依存関係もありません。
4. 1 回の呼び出しで生成されるすべてのアイコンに同じスタイルが適用されるため、セット全体に一貫性が生まれます。
5. サーバーはアイコンごとの SVG マークアップを含む JSON を返し、アシスタントはそれらをプロジェクト内の .svg ファイルとして保存します。

セッション例

You:    I need icons for my landing page nav: home, features, pricing,
        contact. Make them all match: thin 1.5 stroke, blue #2f6bff.

Claude: [calls generate_icons with ["home", "features", "pricing",
        "contact"], stroke_width=1.5, color="#2f6bff"]
        Done. Four SVGs, all 1.5px stroke in #2f6bff, saved to icons/.
        "features" resolved to the "sparkles" icon, "contact" to "mail".

Unicon ではなく icon-mcp を選ぶ理由

Unicon は最も近い既存ツールです。ホスト型アイコン API を利用する MCP サーバーで、9 つのライブラリから 19,000 個以上のアイコンを提供します。icon-mcp はその逆を選びます。

• 完全にオフライン。 アイコンセット全体がパッケージに同梱されています。ホスト型 API は不要で、飛行機の中でも使えます。
• アカウント不要、プラン制限なし。 永久に無料で、登録も不要です。
• Python ネイティブ。 uvx／pip でインストールでき、Node や npx は不要です。
• 1 回の呼び出しで統一感のあるセットを生成。 アイコンのリストと 1 つのスタイルを渡すと、すべての SVG が統一されたスタイルで返されます。スタイルのパラメーター（線の太さ、色、サイズ）は後付けではなく、主要な機能として用意されています。
• 機能を絞ったシンプルな構成。 ツール 2 つ、ライブラリ 1 つ、設定ゼロです。

トレードオフは、9 つではなく 1 つのライブラリ（Lucide）を使うこと、そしてセマンティック検索ではなくキーワード検索を使うことです。ページに統一感のあるアイコンセットを配置するのが目的なら、それだけで十分です。

パラメーター

generate_icons で指定できるパラメーターは次のとおりです。

パラメーター	デフォルト	ルール
icons	(必須)	名前またはキーワード検索クエリを1～50個指定します。例：["home", "trash can"]
stroke_width	2.0	0.5～4（2はLucideのデフォルト値）
color	"currentColor"	currentColor、16進数（#2f6bff）、またはCSS名（red）
size	24	1～1024ピクセル

一致するアイコンが見つからないクエリは、呼び出し全体を失敗させるのではなく、unresolved リストに報告されます。

ロードマップ

• v0.1 — 同梱のLucideセット（v1.50.0）、キーワード検索、パラメーターによるSVGのスタイル設定、1回の呼び出しでの一括セット
• Webサイト：プロンプトを貼り付けて、スタイル設定済みのセットをダウンロード
• 他のライブラリ（Tabler、Heroicons）をオプトイン形式のバンドルとして追加

コントリビューション

イシューやプルリクエストを歓迎します。ツールを追加する場合は、その説明を、初めて見る人にもわかるように書いてください。アシスタントはその説明を読んで、いつ使用するかを判断します。アイコンバンドルを新しいLucideリリースに更新するには、scripts/fetch_lucide.py の LUCIDE_VERSION を更新して実行してください。

ライセンス

MIT © Pratham Jain。LICENSE を参照してください。

謝辞

Lucideのアイコンセット（ISCライセンス、icon_mcp/LUCIDE_LICENSE を参照）とModel Context Protocolを基盤として構築されています。