Public Apis Mcp

Public APIs MCP サーバー

English | 中文

public-apis データベースへのインテリジェントなアクセスと管理機能を提供する、Model Context Protocol（MCP）サーバーです。

🚀 プロジェクト概要

Public APIs MCP Server は、開発者に便利なパブリック API の発見、検索、統合サービスを提供するために設計された、プロフェッショナルな MCP サーバー実装です。標準化された MCP プロトコルにより、豊富なパブリック API リソースをさまざまな AI アシスタントや開発ツールに簡単に統合できます。

主な機能

• 🔍 スマート検索：カテゴリー、キーワード、認証方式など、複数の条件で API を検索します。
• 🛡️ セキュリティフィルタリング：HTTPS 対応や CORS 設定などを含め、セキュリティに関する条件で絞り込みます。
• 🎯 スマートレコメンデーション：プロジェクトの要件に基づいて、最適な API をインテリジェントに提案します。
• 💻 コード生成：複数のプログラミング言語で API 統合コードを自動生成します。
• 📊 統計分析：API データの詳細な統計と分析を提供します。
• 🔄 リアルタイム同期：GitHub リポジトリから最新の API データを同期できます。

📸 プレビュー

📦 インストール

要件

• Node.js >= 18.0.0
• npm >= 8.0.0

クイックインストール

# Clone the project
git clone https://github.com/worryzyy/public-apis-mcp.git
cd public-apis-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

開発モード

# Start in development mode (with hot reload)
npm run dev

🛠️ 使用方法

基本設定

サーバーの起動後、標準入力／出力を通じて MCP クライアントと通信します。MCP プロトコルに対応した AI アシスタントや開発ツールで、このサーバーを設定できます。

MCP クライアントの設定例

{
  "mcpServers": {
    "public-apis-mcp": {
      "command": "node",
      "args": ["path/to/public-apis-mcp/dist/index.js"]
    }
  }
}

または

{
  "mcpServers": {
    "public-apis-mcp": {
      "command": "npx",
      "args": ["-y", "@weilei_kyle/public-apis-mcp"]
    }
  }
}

🔧 利用可能なツール

API の検索と発見

search_apis_by_category

カテゴリーで API を検索します。

パラメーター：

• category（string、必須）：API のカテゴリー名
• limit（number、任意）：返される結果の件数。デフォルトは 10

例：

{
  "category": "Weather",
  "limit": 5
}

search_apis_by_keyword

キーワードで API を検索します。

パラメーター：

• keyword（string、必須）：検索キーワード
• limit（number、任意）：返される結果の件数。デフォルトは 10

filter_apis_by_auth

認証要件で API を絞り込みます。

パラメーター：

• authType（string、必須）：認証タイプ（No、apiKey、OAuth、X-Mashape-Key、User-Agent）
• limit（number、任意）：返される結果の件数。デフォルトは 10

filter_apis_by_https

HTTPS に対応した API を絞り込みます。

パラメーター：

• httpsOnly（boolean、任意）：HTTPS に対応した API のみを返すかどうか。デフォルトは true
• limit（number、任意）：返される結果の件数。デフォルトは 10

filter_apis_by_cors

クロスオリジンアクセスに対応した API を絞り込みます。

パラメーター：

• corsSupport（string、必須）：CORS の対応状況（yes、no、unknown）
• limit（number、任意）：返される結果の件数。デフォルトは 10

API の詳細と統計

get_api_details

特定の API の詳細情報を取得します。

パラメーター：

• apiName（string、必須）：API 名

get_category_list

利用可能なすべての API カテゴリーの一覧を取得します。

get_random_api

API をランダムに提案します。

パラメーター：

• category（string、任意）：特定のカテゴリー内にランダム選択を限定します。

get_api_statistics

API 数の統計情報を取得します。

analyze_auth_requirements

認証方式ごとの API の分布を分析します。

スマートレコメンデーション

recommend_apis_for_project

プロジェクトの要件に基づいて、適切な API を提案します。

パラメーター：

• projectType（string、必須）：プロジェクトの種類の説明
• requirements（array、任意）：プロジェクト要件の一覧
• limit（number、任意）：提案する API の件数。デフォルトは 5

find_alternative_apis

代替 API の選択肢を検索します

パラメーター：

• functionality（文字列、必須）：必要な機能の説明
• limit（数値、任意）：返される結果の上限。デフォルトは 5 です

コード生成

generate_api_integration_code

選択した API の統合コード例を生成します

パラメーター：

• apiName（文字列、必須）：API 名
• language（文字列、任意）：プログラミング言語（javascript、python、curl）。デフォルトは javascript です

データ管理

sync_repository_data

GitHub リポジトリから最新の API リストを同期します

重要な注意事項：このインターフェースでは現在、public-apis リポジトリの最新データをローカルサーバーに同期するため、手動同期の仕組みを使用しています。これは主に、データの安定性とアクセス速度を確保するためのものです。

仕組み：

• GitHub リポジトリから最新の API データを取得する処理を手動で実行します
• データをローカルサーバーにキャッシュして、クエリのパフォーマンスを向上させます
• 差分更新と強制的な完全同期の両方に対応しています
• 完了後、詳細な同期ステータスレポートを返します

パラメーター：

• force（ブール値、任意）：強制的に再同期するかどうか。デフォルトは false です
  • false：データの有効期限が切れている場合にのみ、差分同期を実行します
  • true：ローカルキャッシュを無視して、データを強制的に完全同期します

利用上の推奨事項：

• 初回使用前に、強制同期（force: true）を実行することをおすすめします
• 日常的な使用では、最新データを取得するために定期的に差分同期を実行してください
• データに異常が見つかった場合は、強制同期を使用してローカルキャッシュをリセットしてください

check_new_apis

最近追加された新しい API を確認します

パラメーター：

• days（数値、任意）：過去の日数を対象に新たに追加された API を確認します。デフォルトは 7 日です

📁 プロジェクト構成

public-apis-mcp/
├── src/
│   ├── index.ts                    # Main entry file
│   ├── server/
│   │   └── server.ts              # MCP server implementation
│   ├── services/
│   │   ├── api-service.ts         # API data management service
│   │   ├── search-service.ts      # Search functionality service
│   │   ├── tool-service.ts        # Tool call handling service
│   │   ├── code-generation-service.ts  # Code generation service
│   │   ├── recommendation-service.ts   # Recommendation algorithm service
│   │   └── formatter-service.ts   # Data formatting service
│   └── types/
│       └── api.ts                 # TypeScript type definitions
├── dist/                          # Compilation output directory
├── package.json                   # Project configuration
├── tsconfig.json                  # TypeScript configuration
└── README.md                      # Project documentation

🔧 開発

技術スタック

• TypeScript：型安全な JavaScript のスーパーセット
• Node.js：JavaScript のランタイム環境
• MCP SDK：Model Context Protocol のソフトウェア開発キット
• Axios：HTTP クライアントライブラリ
• Zod：TypeScript を第一に考えたスキーマ検証ライブラリ

ビルドとテスト

# Compile TypeScript
npm run build

# Run tests
npm test

# Development mode (hot reload)
npm run dev

コード規約

このプロジェクトでは、以下の開発規約に従っています。

• 型安全な開発には TypeScript を使用します
• モジュール型アーキテクチャ設計を採用します
• 包括的なエラー処理の仕組みを備えます
• 詳細なコードコメントとドキュメントを記述します

🤝 コントリビューション

このプロジェクトの改善に役立つ Issue や Pull Request の投稿を歓迎します。

コントリビューションの手順

1. このリポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. Pull Request を作成します

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• public-apis - 豊富なパブリック API データソースを提供

📞 お問い合わせ

ご質問やご提案がございましたら、以下からお問い合わせください。

• GitHub Issue を投稿する

---

注：このプロジェクトは現在も活発に開発中であり、API が変更される場合があります。本番環境で使用する前に、十分にテストすることをおすすめします。