MCP Api Client

🚀 mcp-api-client

大語言模型的Postman。這是一個專門為快速進行REST API測試和探索而設計的MCP服務器，資源使用效率高。現在，你的大語言模型助手無需編寫樣板測試代碼，就可以直接與端點進行交互、調試並即時驗證。

本項目基於 FastMCP 和 httpx 構建。

🚀 快速開始

本項目旨在將API測試的強大功能直接融入你的AI輔助開發工作流程中，避免傳統API測試時編寫腳本或切換到Postman等GUI工具的繁瑣操作。

✨ 主要特性

• 大語言模型原生測試：無需編寫測試代碼，使用自然語言即可快速測試端點。
• 資源高效利用：最小化響應格式，減少令牌消耗，默認僅返回狀態和響應體。
• 零樣板代碼原型開發：可立即與新的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

🔧 技術細節

本項目包含一個預編寫的“技能”，用於指導大語言模型代理如何最佳使用此工具。 使用方法：

1. 將 skills/mcp-api.client.md 複製到你的項目代理配置目錄（例如 .cursor/skills/ 或類似目錄）。
2. 你的代理現在將瞭解何時使用此服務器（例如，用於驗證API更改）。

🧪 測試與貢獻

pip install pytest pytest-asyncio
pytest

歡迎貢獻代碼！如果你發現了bug或有功能請求，請提交一個issue或PR。

📄 許可證

本項目採用MIT許可證。詳情請參閱 LICENSE 文件。