api-request-server

API请求MCP服务器

一个用于自动发送 HTTP 请求并验证 JSON 响应的 MCP (Model Context Protocol) 服务器。支持多种 HTTP 方法、代理配置，以及 multipart/form-data 文件上传。

功能特性

• 自动发送 GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS 请求
• 支持 HTTP 和 HTTPS
• 支持 HTTP/HTTPS 代理
• 自动校验响应是否为 JSON
• 支持原始文本请求体
• 支持 multipart/form-data
• 支持普通表单字段和本地文件同时上传

安装

git clone https://github.com/your-username/api-request-server.git
cd api-request-server
npm install
npm run build

配置

可选环境变量

HTTP_PROXY=http://127.0.0.1:8080
HTTPS_PROXY=http://127.0.0.1:8080
NO_PROXY=localhost,127.0.0.1,.local

• HTTP_PROXY: HTTP 请求代理
• HTTPS_PROXY: HTTPS 请求代理
• NO_PROXY: 不走代理的主机列表

Claude Code

配置文件位置：项目根目录 .claude/mcp.json

{
  "mcpServers": {
    "api-request-server": {
      "command": "node",
      "args": [
        "./api-request-server/build/index.js"
      ]
    }
  }
}

如果你是直接在本仓库本地开发和调试，推荐使用绝对路径或与你当前项目结构一致的相对路径，并在修改后重启客户端以重新加载 MCP 配置。

Cline

Windows 配置文件位置： %APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json

{
  "mcpServers": {
    "api-request-server": {
      "autoApprove": [
        "send_api_request"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\path\\to\\api-request-server\\build\\index.js"
      ]
    }
  }
}

本地开发时，也可以直接改成你自己的实际路径，例如：

{
  "mcpServers": {
    "api-request-server": {
      "autoApprove": [
        "send_api_request"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\Users\\gml\\Documents\\Cline\\MCP\\api-request-server\\build\\index.js"
      ]
    }
  }
}

使用示例

GET

send_api_request({
  "url": "https://api.example.com/data"
})

JSON POST

send_api_request({
  "url": "https://api.example.com/submit",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer your-token"
  },
  "body": "{\"key\": \"value\"}"
})

使用代理

send_api_request({
  "url": "https://api.example.com/data",
  "proxy": "http://proxy-server:8080"
})

multipart/form-data 上传

send_api_request({
  "url": "https://api.example.com/upload",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your-token"
  },
  "formFields": {
    "folder": "invoices",
    "public": true,
    "userId": 123
  },
  "files": [
    {
      "fieldName": "file",
      "filePath": "C:\\data\\invoice.pdf",
      "contentType": "application/pdf"
    },
    {
      "fieldName": "attachment",
      "filePath": "C:\\data\\note.txt",
      "filename": "note.txt",
      "contentType": "text/plain"
    }
  ]
})

API参数说明

send_api_request

参数	类型	必需	说明
url	string	是	请求 URL，支持 http:// 和 https://
method	string	否	HTTP 方法，默认 GET
headers	object	否	请求头，键值对形式
body	string	否	原始请求体，适用于 JSON 或其他文本载荷
formFields	object	否	multipart/form-data 普通表单字段，值支持 string、number、boolean
files	array	否	上传文件列表，每项为 { fieldName, filePath, filename?, contentType? }
proxy	string	否	代理地址，格式如 http://host:port

约束：

• body 不能和 formFields、files 同时使用
• files[].filePath 必须是本地真实存在的文件路径
• 上传文件时会自动生成 multipart/form-data 请求头

响应格式

成功时返回：

{
  "data": {
    "key": "value"
  },
  "status": 200,
  "statusText": "OK",
  "headers": {
    "content-type": "application/json"
  }
}

失败时返回：

{
  "content": [
    {
      "type": "text",
      "text": "Request failed: ..."
    }
  ],
  "isError": true
}

代理优先级

• proxy 参数
• 环境变量 HTTP_PROXY / HTTPS_PROXY
• NO_PROXY 命中时不使用代理

注意事项

• 当前实现要求响应可解析为 JSON，否则返回错误
• 目前仅支持 HTTP 和 HTTPS 代理
• .env 不应提交到版本控制系统

开发

npm install
npm run build
npm run watch
npm start

许可证

本项目采用 MIT 许可证，详见 LICENSE。