API Tester MCP

MCP Server for API Testing - HTTP request testing and validation for hermes-agent, Claude Code, Cursor

安装

npm install @zsc-glitch/api-tester-mcp

MCP Tools

1. api_send_request

发送 HTTP 请求：

{
  "tool": "api_send_request",
  "arguments": {
    "url": "https://api.example.com/data",
    "method": "GET",
    "headers": {
      "Authorization": "Bearer token"
    }
  }
}

返回：

• 状态码
• 响应时间
• 响应头
• 响应体预览

2. api_run_test

运行测试（带断言）：

{
  "tool": "api_run_test",
  "arguments": {
    "url": "https://api.example.com",
    "expectedStatusCode": 200,
    "maxResponseTime": 1000,
    "bodyContains": "success"
  }
}

支持的断言：

• 状态码验证
• 响应时间限制
• 响应体内容匹配

3. api_batch_test

批量测试多个 API：

{
  "tool": "api_batch_test",
  "arguments": {
    "tests": [
      { "url": "https://api1.example.com", "expectedStatusCode": 200 },
      { "url": "https://api2.example.com", "expectedStatusCode": 200 }
    ]
  }
}

返回汇总报告：

• 总数
• 通过/失败数
• 通过率

4. api_validate_response

验证 JSON 响应：

{
  "tool": "api_validate_response",
  "arguments": {
    "url": "https://api.example.com/data",
    "jsonPath": "data.id",
    "expectedValue": "123"
  }
}

支持 JSON 路径验证。

与 hermes-agent 配合

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

Made with ❤️ by 小影