MCP Api Client

🚀 mcp-api-client

LLM用のPostman。高速なREST APIのテストと探索に特化した、リソース効率の良いMCPサーバーです。定型的なテストコードを書く代わりに、LLMアシスタントがエンドポイントと直接やり取りし、デバッグし、リアルタイムで検証することができます。

このプロジェクトはFastMCPとhttpxを使用して構築されています。

🚀 クイックスタート

なぜ mcp-api-client を使うのか？

従来のAPIテストでは、スクリプトを書いたり、PostmanのようなGUIツールに切り替えたりする必要がありました。このサーバーは、その機能をAI支援開発ワークフローに直接持ち込みます。

• LLMネイティブなテスト：テストコードを書かずに自然言語でエンドポイントをすばやくテストできます。
• リソース効率が良い：最小限のレスポンス形式でトークン消費を削減し、デフォルトではステータスとボディのみを返します。
• 定型コード不要のプロトタイピング：新しいAPIと即座にやり取りして、その動作を理解できます。
• ローカル開発の相棒：ビルドフェーズでローカル開発サーバー (localhost) をテストするのに最適です。

📦 インストール

必要条件：Python 3.10以上

git clone https://github.com/etaaa/mcp-api-client.git
cd mcp-api-client
pip install .

🛠️ セットアップ

1. インストールされたパスを見つけます。

   which mcp-api-client
   

2. MCPクライアントの設定（例：Claude Desktop）にサーバーを追加します。

   {
     "mcpServers": {
       "api-client": {
         "command": "/full/path/to/mcp-api-client"
       }
     }
   }
   

💻 ツール

http_request

最小限のレスポンスデータで単一のHTTPリクエストを行います。

レスポンス形式：

{
  "status": 200,
  "body": {"key": "value"}
}

http_batch_request

一度の呼び出しで複数のHTTPリクエストを効率的に実行します。複数のエンドポイントをテストする際には、トークン使用量を最小限に抑えるために強く推奨されます。

例：

{
  "requests": [
    {"method": "GET", "url": "http://localhost:8000/health"},
    {"method": "POST", "url": "http://localhost:8000/users", "body": {"name": "Test"}},
    {"method": "GET", "url": "http://localhost:8000/users/1"}
  ]
}

返り値：リクエストと同じ順序でレスポンスの配列が返されます。

💻 使用例

基本的な使用法

単一リクエスト：

method: GET
url: http://localhost:8000/health

高度な使用法

バッチテスト (複数のエンドポイントに推奨)：

requests:
  - method: GET
    url: http://localhost:3000/api/health
  - method: POST
    url: http://localhost:3000/api/users
    body: {"name": "Test User", "role": "admin"}
  - method: GET
    url: http://localhost:3000/api/users

🤖 エージェントスキル

このプロジェクトには、LLMエージェントがこのツールを最適に使用する方法を指示する事前に書かれた「スキル」が含まれています。

使用方法：

1. skills/mcp-api.client.md をプロジェクトのエージェント設定（例：.cursor/skills/ など）にコピーします。
2. エージェントはこのサーバーをいつ使用するか（例：APIの変更を検証する場合）を理解するようになります。

🧪 テストと貢献

pip install pytest pytest-asyncio
pytest

貢献は大歓迎です！バグを見つけたり、機能要求がある場合は、イシューを開くか、PRを提出してください。

📄 ライセンス

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