MCP REST API Tester

基于 TypeScript 的 MCP 服务器，用于通过 Cline 测试和交互任何 REST API 端点。

安装选项

方式 1：通过 Smithery 安装 (推荐)

npx -y @smithery/cli install dkmaker-mcp-rest-api --client claude

方式 2：手动安装

1. 全局安装包：

   npm install -g dkmaker-mcp-rest-api
   

2. 配置 Cline 自定义指令 (设置 > 自定义指令)：

   # REST API 测试指令
   `test_request` 工具支持测试、调试和与 REST API 端点交互。该工具提供全面的请求/响应信息，并自动处理身份验证。
   
   ## 使用场景
   - 测试特定的 API 端点
   - 调试 API 响应
   - 验证 API 功能
   - 检查响应时间
   
   ## 主要功能
   - 支持 GET、POST、PUT、DELETE 方法
   - 处理身份验证（基本认证、Bearer 令牌、API 密钥）
   - 提供详细的响应信息
   

3. 添加到 MCP 配置中：

   macOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   {
     "mcpServers": {
       "rest-api": {
         "command": "npx",
         "args": [
           "-y",
           "dkmaker-mcp-rest-api"
         ],
         "env": {
           "REST_BASE_URL": "https://api.example.com",
           "AUTH_BEARER": "your-token"
         }
       }
     }
   }
   

   Windows：替换 <YourUsername> 并使用完整路径：

   {
     "mcpServers": {
       "rest-api": {
         "command": "node",
         "args": [
           "C:/Users/<YourUsername>/AppData/Roaming/npm/node_modules/dkmaker-mcp-rest-api/build/index.js"
         ],
         "env": {
           "REST_BASE_URL": "https://api.example.com",
           "AUTH_BEARER": "your-token"
         }
       }
     }
   }
   

常用配置选项

"env": {
  "REST_BASE_URL": "https://api.example.com",
  
  // 身份验证选项 (选择一种)
  "AUTH_BASIC_USERNAME": "your-username",
  "AUTH_BASIC_PASSWORD": "your-password",
  // 或
  "AUTH_BEARER": "your-token",
  // 或
  "AUTH_APIKEY_HEADER_NAME": "X-API-Key",
  "AUTH_APIKEY_VALUE": "your-api-key",
  
  // 其他可选配置
  "REST_ENABLE_SSL_VERIFY": "false",
  "REST_RESPONSE_SIZE_LIMIT": "10000",
  
  // 自定义头
  "HEADER_X-API-Version": "2.0",
  "HEADER_Custom-Client": "my-client"
}

使用示例

// GET 请求示例
use_mcp_tool('rest-api', 'test_request', {
  "method": "GET",
  "endpoint": "/users"
});

// POST 请求示例
use_mcp_tool('rest-api', 'test_request', {
  "method": "POST",
  "endpoint": "/users",
  "body": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "headers": {
    "Accept-Language": "en-US"
  }
});

支持的功能

• HTTP 方法：GET、POST、PUT、DELETE
• 自定义请求头和请求体
• 多种认证方式：Basic、Bearer、API Key
• SSL 证书验证配置
• 响应大小管理 (默认 10KB)
• 详细的请求/响应信息

了解更多信息，请访问 GitHub 仓库。