API-MARKET MCP Server

API-MARKET MCP Server

概要

API-Market のエンドポイントを MCP リソースとして公開する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、LLM は MCP プロトコルを通じて、OpenAPI 仕様で定義された API を見つけて操作できます。
このリポジトリでは、API.market で利用できる API にアクセスできます。このツールは無料で利用でき、エージェントは利用可能なすべての API と自由に通信できます。そのため、非常に強力です。API.market では 200 以上の API を利用でき、幅広い機能を活用できます。

クイックスタート

この MCP サーバーを使うために、このリポジトリをクローンする必要はありません。お好みのクライアントで設定するだけで利用できます。

Claude Desktop の場合

1. Claude Desktop の設定ファイルを探すか、新規作成します。
   • macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
2. API-Market MCP サーバーを有効にするため、次の設定を追加します。

   {
     "mcpServers": {
       "api-market": {
         "command": "npx",
         "args": ["-y", "@noveum-ai/mcp-server"],
         "env": {
           "API_HEADERS": "x-magicapi-key:your-api-key"
         }
       }
     }
   }
   

Cursor の場合

1. File -> Preferences -> Cursor Settings に移動します。
2. MCP を選択します。
3. Add new global MCP Server をクリックします。
4. 次の内容を mcp.json ファイルに貼り付けます。

  {
    "mcpServers": {
      "api-market": {
        "command": "npx",
        "args": [
          "-y",
          "@noveum-ai/mcp-server",
          "--headers",
          "x-magicapi-key:<your-api-key>"
        ]
      }
    }
  }

または、これを mcpServers の最初のエントリとして追加します。

    "api-market": {
      "command": "npx",
      "args": [
        "-y",
        "@noveum-ai/mcp-server",
        "--headers",
        "x-magicapi-key:<your-api-key>"
      ]
    },

5. 古いバージョンの Cursor では、Add new MCP server をクリックした後、次のコマンドを追加します。

npx -y @noveum-ai/mcp-server --headers x-magicapi-key:your-api-key

API.market から API キーを取得する

API キーを取得するには：

1. API.market にログインします。
2. プロフィールに移動し、「My API Keys」を選択します。
3. API キーがここに表示されます。

この MCP の API 一覧

• GET-trueway-matrix-MatrixService-CalculateDrivingMatrix
• GET-magicapi-whisper-predictions--request_id
• POST-magicapi-whisper-whisper
• POST-capix-faceswap-upload
• POST-capix-faceswap-faceswap-v1-image
• POST-capix-faceswap-faceswap-v1-video
• POST-capix-faceswap-result
• GET-trueway-geocoding-GeocodingService-Geocode
• GET-trueway-geocoding-GeocodingService-ReverseGeocode
• POST-magicapi-dnschecker-dnschecker
• GET-magicapi-coder-predictions--request_id
• POST-magicapi-coder-coder
• POST-bridgeml-nsfw-detection-nsfw_detection
• GET-magicapi-whois-whois--domain-
• GET-magicapi-deblurer-predictions--request_id
• POST-magicapi-deblurer-deblurer
• POST-bridgeml-text-to-image-text_to_image
• GET-magicapi-period-predictions--request_id
• POST-magicapi-period-period
• GET-trueway-places-PlacesService-FindPlaceByText
• GET-trueway-places-PlacesService-FindPlacesNearby
• GET-magicapi-hair-predictions--request_id
• POST-magicapi-hair-hair
• POST-bridgeml-codellama-bridgeml-codellama
• GET-brave-brave-videos-search
• GET-brave-brave-web-search
• GET-brave-brave-images-search
• GET-brave-brave-news-search
• GET-brave-brave-suggest-search
• GET-brave-brave-spellcheck-search
• POST-magicapi-domainchecker-check_domains
• GET-trueway-routing-DirectionsService-FindDrivingRoute
• GET-trueway-routing-DirectionsService-FindDrivingPath
• POST-pipfeed-parse-extract

例と使い方

例 1

エージェントを使って、任意の 2 地点間のルートを検索できます。

例 2

エージェントを使って任意のトピックに関するニュースを検索し、記事をさらに詳しく調べることができます。

例 3

エージェントを使って、利用可能なドメインを検索できます。

開発

MCP サーバーへの API の追加

utils フォルダーには、API 設定の管理、OpenAPI 仕様の解析、新しい API の MCP サーバーへの登録に使用するヘルパースクリプトが含まれています。

1. OpenAPI 仕様を探す

連携する API の OpenAPI JSON を探します。その後、プロジェクトのルートディレクトリに json_files フォルダーを作成し、そのフォルダーに OpenAPI JSON 仕様を追加します。

2. OpenAPI 仕様を変更する

OpenAPI 仕様を取得したら、modify_api.py を使用して、仕様内のパスにファイル名を含めるよう更新します。

python utils/modify_api.py

3. API の概要を更新する

パスを変更した後、次のいずれかの方法で API の概要を更新します。

• LLM を使って概要を自動的に短縮する：

python utils/LLM_summary_shortener.py 

• 概要を手動で更新する：

python utils/manual_summary_shortener.py 

4. ビルドとテスト

変更を反映するため、プロジェクトを再ビルドします。

npm run build

次に、以下を使って新しい API 統合をテストします。

npm run inspect

5. 変更を提出する

この新しい API をリポジトリに追加したい場合は、次の手順を実行します。

• リポジトリをフォークします。
• ブランチを作成します。
• プルリクエスト（PR）を送信します。

6. MCP サーバーを公開する（任意）

変更を公開したい場合は、次の手順を実行します。

• package.json を適宜更新します（バージョン、名前など）。
• パッケージを公開します。

npm publish --access public

開発ツール

ビルド

• npm run build - TypeScript ソースをビルドします。
• npm run clean - ビルド成果物を削除します。
• npm run typecheck - TypeScript の型チェックを実行します。

開発モード

• npm run dev - ソースファイルを監視し、変更時に再ビルドします。
• npm run inspect-watch - 変更時に自動再読み込みするインスペクターを実行します。

コード品質

• npm run lint - ESLint を実行します。
• npm run typecheck - TypeScript の型を検証します。

コマンドライン引数

npm run inspect -- \
  --api-base-url https://api.magicapi.dev/api/v1/ \
  --openapi-spec modified_files.txt \
  --headers "x-magicapi-key:your-api-key" \
  --name "my-mcp-server" \
  --version "1.0.0"

開発ワークフロー

1. 開発環境を起動します。

npm run inspect-watch

2. src/ 内の TypeScript ファイルを変更します。
3. サーバーは自動的に再ビルドされ、再起動します。
4. MCP Inspector UI を使って変更をテストします。

デバッグまたはローカルでの実行

MCP サーバーをローカルでデバッグまたは実行するには、次の手順を実行します。

1. リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/Noveum/api-market-mcp-server.git
cd api-market-mcp-server
npm install

2. サーバーをビルドします。

npm run build

3. デバッグする場合は、次を実行します。

npm run inspect 

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. テストと lint を実行します。

npm run typecheck
npm run lint

5. プルリクエストを送信します。

ライセンス

MIT