API-MARKET MCPサーバー

について

API-Market のエンドポイントを MCP リソースとして公開するモデルコンテキストプロトコル (MCP) サーバー。このサーバーにより、大規模言語モデルは MCP プロトコルを介して OpenAPI 仕様で定義された API を検出し、操作できるようになります。
このリポジトリは、 API.marketで利用可能なAPIへのアクセスを提供します。このツールは無料で利用でき、エージェントは利用可能なすべてのAPIと自由に通信できるため、非常に強力です。API.marketには200以上のAPIが用意されており、幅広い機能を活用できます。

Related MCP server: OpenAPI MCP Server

クイックスタート

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

クロードデスクトップ向け

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"
         }
       }
     }
   }

カーソル用

1. 「ファイル」->「設定」->「カーソル設定」に移動します。

2. MCPを選択します。

3. 新しいグローバル MCP サーバーの追加をクリックします。

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の古いバージョンの場合は、新しいMCPサーバーの追加をクリックした後、次のコマンドを追加します。

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

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

APIキーを取得するには

1. API.marketにログイン

2. プロフィールに移動して「マイAPIキー」を選択します

3. APIキーはここに表示されます

このMCPのAPIのリスト

• GET-trueway-matrix-MatrixService-CalculateDrivingMatrix

• GET-magicapi-whisper-predictions--request_id

• POST-マジカピ-ウィスパー-ウィスパー

• POST-capix-faceswap-upload

• POST-capix-faceswap-faceswap-v1-image

• POST-capix-faceswap-faceswap-v1-ビデオ

• 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--ドメイン-

• GET-magicapi-deblurer-predictions--request_id

• POST-magicapi-deblurer-deblurer

• POST-bridgeml-テキストから画像へ-text_to_image

• GET-magicapi-period-predictions--request_id

• POST-マジカピ-ピリオド-ピリオド

• GET-trueway-places-PlacesService-FindPlaceByText

• GET-trueway-places-PlacesService-FindPlacesNearby

• GET-マジカピ-ヘア予測--リクエストID

• POST-マジカピ-ヘア-ヘア

• POST-ブリッジml-コデラマ-ブリッジml-コデラマ

• 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 仕様の解析、MCP サーバーへの新しい API の登録を行うためのヘルパー スクリプトが含まれています。

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. テストとリンティングを実行します。

npm run typecheck
npm run lint

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

ライセンス

マサチューセッツ工科大学