noun-mcp について
noun-mcpは、AIアシスタントからThe Noun Projectを検索し、アイコンをプロジェクトにダウンロードするMCPサーバーです。スタイルやライセンスによる絞り込み、コレクションの閲覧、SVGまたはPNGの出力設定に対応します。
主な機能
- 01スタイルとライセンスで検索
- 02SVGまたはPNGをダウンロード
- 03出力色とサイズの指定
- 04厳選コレクションの閲覧
- 05検索語のオートコンプリート
- 06APIとアイコンの使用量追跡
活用シーン
- 01パブリックドメインのコーヒーカップアイコン探し
- 02色付きアイコンのプロジェクトへの保存
- 03月間API使用量の確認
MCP 対応
このMCPサーバーは、The Noun Projectの検索、閲覧、ダウンロード、使用量追跡を行う7つのツールを提供します。Cursor、Claude Desktop、Claude CodeなどのMCPクライアントに設定できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @alisaitteke/noun-mcpNOUN_CONSUMER_KEYシークレットConsumer Key from The Noun Project APINOUN_CONSUMER_SECRETシークレットConsumer Secret from The Noun Project APINOUN_API_TIERAPI tier: FREE (trial quotas) or PAID (Pay-Per-Use)ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
7掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| limit | number | いいえ | 結果の最大件数 |
| query | string | はい | 検索語（例："dog"、"house"、"bicycle"） |
| styles | enum | いいえ | アイコンのスタイル：solid、line、または bothsolid | line | solid,line |
| next_page | string | いいえ | 次のページのトークン |
| prev_page | string | いいえ | 前のページのトークン |
| include_svg | enum | いいえ | レスポンスに SVG URL を含める（1=はい、0=いいえ）0 | 1 |
| line_weight | number|string | いいえ | 線画アイコンの線幅（1～60）または範囲（例："18-20"） |
| thumbnail_size | enum | いいえ | サムネイルのサイズ（ピクセル）42 | 84 | 200 |
| limit_to_public_domain | enum | いいえ | パブリックドメインのアイコンのみを表示（1=はい、0=いいえ）0 | 1 |
詳細
Noun MCP
言語： 英語 · 简体中文 · スペイン語 · ドイツ語 · 日本語 · トルコ語
アイコンを普通の言葉でリクエストできます。 必要なものを説明すると（「パブリックドメインの、塗りつぶされたコーヒーカップ」など）、 AI アシスタントが The Noun Project を検索して合うものを選び、SVG または PNG を プロジェクトにダウンロードします。Cursor、Claude Desktop、Claude Code で利用できます。
注： これは非公式のコミュニティメンテナンスプロジェクトであり、The Noun Project とは提携しておらず、同プロジェクトの承認も受けていません。
何ができますか？
- 検索 — スタイル、線の太さ、パブリックドメインのライセンスで絞り込み
- ダウンロード — SVG または PNG をカスタムの色とサイズで、指定したパスに保存
- コレクションを閲覧 — 単発の検索だけでなく、厳選されたアイコンセットを表示
- オートコンプリート — 利用枠を使い切る前に、より適切な検索語を取得
- 使用状況を追跡 — サービス呼び出しとアイコン呼び出しの時間別、日別、月別の利用状況
- 無料トライアルを長持ちさせる — クライアント側の上限設定により、月150回のアイコン呼び出しをより長く利用
内部では7つのツールを利用します — 全リストは docs/available-tools.md をご覧ください。
こんなふうに頼んでみてください
Find solid public-domain coffee cup icons, then download one as a red SVG into ./icons.
Suggest search terms for "spo", then search weather collections.
How many Noun Project API calls have I used this month?
はじめに
Node.js 18+ と Noun Project API キーが必要です（アプリを作成 — 無料アカウントで利用できます）。NOUN_API_TIER を FREE（月2,000回のサービス呼び出し／150回のアイコン呼び出し）または PAID に設定します。利用枠の詳細：docs/available-tools.md。
インストール後、your_key / your_secret を Consumer Key と Secret に置き換えてください。
Claude Code：
claude mcp add \
--transport stdio \
noun-project \
--env NOUN_CONSUMER_KEY=your_key \
--env NOUN_CONSUMER_SECRET=your_secret \
--env NOUN_API_TIER=FREE \
-- npx -y @alisaitteke/noun-mcp
または、MCP クライアント（Cursor、Claude Desktop など）の設定に追加してください：
{
"mcpServers": {
"noun-project": {
"command": "npx",
"args": ["-y", "@alisaitteke/noun-mcp"],
"env": {
"NOUN_CONSUMER_KEY": "your_key",
"NOUN_CONSUMER_SECRET": "your_secret",
"NOUN_API_TIER": "FREE"
}
}
}
}
すぐに使えるファイル：examples/cursor-config.json、examples/claude-desktop-config.json。
仕組み
- 必要なものを自然な言葉で入力します。
- AI がまず検索します —
search_iconsは低コストのサービス呼び出しで、ID、ライセンス、サムネイルを返します。 - ファイルが必要なときだけダウンロードします —
download_icon/get_iconを呼び出すたびに、アイコン呼び出しを消費します。
クォータエラーが発生しましたか？check_usage を実行するよう依頼してから、待つか条件を絞り込みます。よくある解決方法については、docs/troubleshooting.mdをご覧ください。
ドキュメント
- 利用可能なツール — 7つのツールすべて、パラメーター、FREE と PAID
- トラブルシューティング — キー、429、パブリックドメインからのダウンロード
- アーキテクチャ — OAuth、キュー、再試行、キャッシュ
- 開発 — ソースからのビルド、テスト
コントリビューション
コントリビューションを歓迎します！PR を作成する前に、CONTRIBUTING.mdをお読みください。
メンテナー
Ali Sait Teke が開発しました — GitHub · LinkedIn。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。