Noun Project

Noun Project MCP Server

The Noun Project API 用の Model Context Protocol（MCP）サーバーです。Claude Code からプログラムでアイコンを検索、取得できます。

特長

• アイコン検索：高度なフィルター（スタイル、線の太さ、パブリックドメイン）を使ってアイコンを検索します
• アイコンの詳細：特定のアイコンに関する詳細情報を取得します
• コレクション：アイコンのコレクションを取得します
• オートコンプリート：検索語句の候補を取得します
• 使用状況の追跡：API のクォータと使用状況を確認します
• ダウンロード URL：色やサイズを指定したカスタムダウンロードリンクを取得します

前提条件

1. Node.js：バージョン 18 以降
2. Noun Project API の認証情報：The Noun Project から API キーとシークレットを取得します

インストール

クイックインストール（推奨）

npm から直接インストールし、1 つのコマンドで Claude Code に追加します。

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- npx -y noun-project-mcp

your_api_key_here と your_api_secret_here を、The Noun Project で取得した実際の認証情報に置き換えてください。

ローカル開発

1. リポジトリをクローンして移動します。

git clone https://github.com/sgup/noun-project-mcp.git
cd noun-project-mcp

2. 依存関係をインストールします。

npm install

3. TypeScript コードをビルドします。

npm run build

4. ローカルパスを使って Claude Code に追加します。

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- node /absolute/path/to/noun-project-mcp/dist/index.js

利用可能なツール

1. search_icons

さまざまなフィルターを使ってアイコンを検索します。

パラメーター：

• query（必須）：検索語句（例：「dog」、「house」）
• styles（任意）：スタイルで絞り込みます。「solid」、「line」、または「solid,line」を指定します
• line_weight（任意）：線アイコンの太さ（1～60）または範囲（例：「18-20」）を指定します
• limit_to_public_domain（任意）：パブリックドメインのみにする場合は 1 を指定します
• thumbnail_size（任意）：42、84、または 200 ピクセル
• include_svg（任意）：SVG URL を含める場合は 1 を指定します
• limit（任意）：結果の最大数

例：

{
  "query": "dog",
  "styles": "line",
  "limit": 10
}

2. get_icon

特定のアイコンに関する詳細情報を取得します。

パラメーター：

• icon_id（必須）：アイコン固有の ID
• thumbnail_size（任意）：42、84、または 200 ピクセル

例：

{
  "icon_id": 12345,
  "thumbnail_size": 200
}

3. get_collection

コレクションとそのアイコンを取得します。

パラメーター：

• collection_id（必須）：コレクション固有の ID
• thumbnail_size（任意）：42、84、または 200 ピクセル
• include_svg（任意）：SVG URL を含める場合は 1 を指定します
• limit（任意）：返すアイコンの最大数

例：

{
  "collection_id": 123
}

4. icon_autocomplete

検索語句のオートコンプリート候補を取得します。

パラメーター：

• query（必須）：検索語句の一部
• limit（任意）：候補の最大数

例：

{
  "query": "hom",
  "limit": 5
}

5. check_usage

現在の API 使用状況と上限を確認します。

パラメーター： なし

6. get_download_url

カスタマイズしたアイコンのダウンロード URL を取得します。

パラメーター：

• icon_id（必須）：アイコン固有の ID
• color（任意）：16 進数の色（例：「FF0000」）
• filetype（任意）：「svg」または「png」
• size（任意）：PNG の場合はサイズをピクセル単位で指定します（20～1200）

例：

{
  "icon_id": 12345,
  "color": "FF0000",
  "filetype": "png",
  "size": 512
}

開発

自動再ビルドを有効にして開発モードで実行します。

npm run dev

本番用にビルドします。

npm run build

サーバーを起動します。

npm start

API リファレンス

この MCP サーバーは The Noun Project API v2 を使用します。API の詳細については、以下を参照してください。

• API ドキュメント
• 移行ガイド

認証

The Noun Project API は OAuth 1.0 認証を使用します。このサーバーは、API 認証情報を使った OAuth 署名をすべて自動的に処理します。

使用制限

The Noun Project API には月間の使用制限があります。クォータの確認には check_usage ツールを使用してください。

トラブルシューティング

「NOUN_PROJECT_API_KEY and NOUN_PROJECT_API_SECRET must be set」

claude mcp add の実行時に --env フラグを指定したことを確認してください。次のコマンドで設定を確認できます。

claude mcp list

認証情報を更新するには、サーバーを削除して再度追加します。

claude mcp remove noun-project
claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_new_key \
  --env NOUN_PROJECT_API_SECRET=your_new_secret \
  -- npx -y noun-project-mcp

「Invalid signature」エラー

API キーとシークレットが正しく、The Noun Project のダッシュボードで再生成されていないことを確認してください。

接続の問題

インターネットに接続されていること、および The Noun Project API にアクセスできることを確認してください。

ライセンス

MIT

サポート

この MCP サーバーに関する問題については、リポジトリに issue を作成してください。

The Noun Project API に関する問題については、サポートページをご覧ください。