Public Apis MCP

🚀 公開API MCP

意味検索機能を備えた無料の公開APIのカタログです。

このカタログには、public-apis GitHubリポジトリの多数のAPIが含まれています。 すべてのメンテナ、コントリビューター、API作成者の皆様、ありがとうございます！ 💯

✨ 主な機能

• search_public_apis：API名と説明に対する埋め込みベースの検索
• get_public_api_details：idによって完全な詳細を取得
• リソース: public-apis://apis, public-apis://api/{id}

📦 インストール

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

リントとフォーマット

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インスペクターを使用したテスト

このサーバーを探索および/または開発するには、MCPインスペクターnpmユーティリティを使用します。

# MCPインスペクターをインストール
npm install -g @modelcontextprotocol/inspector

# インスペクターでローカル開発サーバーを実行
npx @modelcontextprotocol/inspector uv run public-apis-mcp

# インスペクターでPyPI本番サーバーを実行
npx @modelcontextprotocol/inspector uvx public-apis-mcp

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🤝 コントリビューション

コントリビューションは大歓迎です！ ぜひプルリクエストを送信してください。