AI导哈

API请求服务器

一个用于自动发送 HTTP 请求并验证 JSON 响应的 MCP 服务器，支持多种 HTTP 方法、代理配置及文件上传。

  • by Nicolas-One
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Nicolas-Gong/api-request-mcp-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
}

代理优先级

  1. proxy 参数
  2. 环境变量 HTTP_PROXY / HTTPS_PROXY
  3. NO_PROXY 命中时不使用代理

注意事项

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

开发

npm install
npm run build
npm run watch
npm start

许可证

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

相关 MCP