Public Apis Mcp

Public APIs MCP

セマンティック検索に対応した、無料公開 API のカタログです。

カタログには、GitHub リポジトリ public-apis に掲載されている API が幅広く含まれています。
メンテナー、コントリビューター、API 作成者の皆さまに感謝します！💯

🎯 特徴

• search_public_apis：API 名と説明を対象にした、埋め込みベースの検索
• get_public_api_details：id を指定して詳細情報を取得
• リソース：public-apis://apis、public-apis://api/{id}

🔧 セットアップ（uv）

uv を使って MCP クライアント（Claude Desktop など）に追加します。

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

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

🚀 使用方法

• 埋め込みインデックスを構築します（省略可能。初回検索時に自動で構築されます）。

uvx public-apis-mcp build-index

• STDIO 経由で MCP サーバーを実行します。

uvx public-apis-mcp run

📋 ツールリファレンス

search_public_apis

• 目的：カタログをセマンティック検索します
• パラメーター：query（str）、limit（int、デフォルトは 5）
• 戻り値：{ id, name, score, snippet } のリスト

呼び出しペイロードの例：

{ "name": "search_public_apis", "arguments": { "query": "weather", "limit": 5 } }

get_public_api_details

• 目的：id を指定して詳細情報を取得します
• パラメーター：id（str）
• 戻り値：ApiItem

呼び出しペイロードの例：

{ "name": "get_public_api_details", "arguments": { "id": "a6b3a6b3-a6b3-a6b3-a6b3-a6b3a6b3a6b3" } }

🛠️ 開発

前提条件：

• Python 3.10+
• uv（https://docs.astral.sh/uv/）

セットアップ：

uv sync --dev

テストを実行：

FREE_APIS_MCP_TEST_MODE=1 uv run pytest -q

Lint とフォーマット：

uv run ruff check --fix
uv run ruff format

型チェック：

uv run mypy src/

MCP クライアント開発用設定

{
  "mcpServers": {
    "public-apis-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "<abs_path>/public-apis-mcp",
        "run",
        "public-apis-mcp"
      ]
    }
  }
}

ビルドして試す

uv build
uv run --with dist/*.whl public-apis-mcp --help

📦 データとインデックス

• データ：src/public_apis_mcp/datastore/free_apis.json
• 埋め込みインデックス：src/public_apis_mcp/datastore/index.npz（自動構築）

MCP Inspector でのテスト

このサーバーを調査または開発するには、MCP Inspector の npm ユーティリティを使用します。

# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Run local development server with the inspector
npx @modelcontextprotocol/inspector uv run public-apis-mcp

# Run PyPI production server with the inspector
npx @modelcontextprotocol/inspector uvx public-apis-mcp

📝 ライセンス

MIT License。詳細は LICENSE ファイルをご覧ください。

🤝 コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。