API请求MCP服务器

一个强大的MCP (Model Context Protocol) 服务器，用于自动发送HTTP请求并验证JSON响应。支持多种协议、代理配置和中文错误提示。

✨ 功能特性

🚀 自动API请求: 支持GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS等HTTP方法
🌐 多种协议: 支持HTTP和HTTPS协议
🛡️ JSON验证: 自动验证响应格式，确保返回有效JSON数据
🔄 代理支持: 支持HTTP/HTTPS代理配置
⚡ 自动执行: 配置后无需手动确认即可执行API请求
🇨🇳 中文界面: 所有错误信息和说明使用中文显示
🔧 环境变量: 支持通过环境变量配置代理
📊 详细响应: 返回完整的状态码、响应头和数据

📦 安装步骤

1. 下载项目

git clone https://github.com/your-username/api-request-server.git cd api-request-server

2. 安装依赖

npm install

3. 构建项目

npm run build

⚙️ 配置方法

MCP服务器配置

在Cline的配置文件中添加服务器配置：

文件位置: C:\Users\[用户名]\AppData\Roaming\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" ], "env": { "HTTP_PROXY": "http://127.0.0.1:8080", "HTTPS_PROXY": "http://127.0.0.1:8080", "NO_PROXY": "localhost,127.0.0.1,.local" } } } }

重要: 请将 C:\\path\\to\\api-request-server\\build\\index.js 替换为实际的项目路径。

环境变量说明

HTTP_PROXY: HTTP请求的代理服务器地址
HTTPS_PROXY: HTTPS请求的代理服务器地址
NO_PROXY: 不使用代理的主机列表，用逗号分隔

🚀 使用方法

基本GET请求

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

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" })

完整示例

send_api_request({ "url": "https://httpbin.org/post", "method": "POST", "headers": { "Content-Type": "application/json", "User-Agent": "API-Request-MCP/1.0" }, "body": "{\"test\": \"data\", \"timestamp\": \"2024-01-01\"}", "proxy": "http://127.0.0.1:8080" })

📋 API参数说明

send_api_request 参数

参数	类型	必需	说明
`url`	string	✅	请求的URL，支持http://和https://
`method`	string	❌	HTTP方法，默认GET。支持：GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
`headers`	object	❌	请求头对象，键值对形式
`body`	string	❌	请求体内容，POST等方法使用
`proxy`	string	❌	代理服务器地址，格式：http://host:port

📤 响应格式

成功响应格式：

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

错误响应格式：

{ "content": [ { "type": "text", "text": "请求失败: 错误信息" } ], "isError": true }

🔧 高级配置

代理配置优先级

最高优先级: 通过 proxy 参数直接指定
中等优先级: 环境变量配置 (HTTP_PROXY, HTTPS_PROXY)
最低优先级: 如果URL在NO_PROXY列表中，不使用代理

超时设置

默认超时时间为30秒，如需修改可在代码中调整：

timeout: 30000, // 30秒

❓ 常见问题

Q: 为什么无法选中autoApprove？

A: 这是Cline的UI限制。配置文件中正确设置后，工具会自动执行，无需手动确认。

Q: 如何配置代理？

A: 有两种方式：

在MCP配置的env中设置HTTP_PROXY和HTTPS_PROXY
在API调用时通过proxy参数指定

Q: 支持哪些代理协议？

A: 目前支持HTTP和HTTPS代理。SOCKS代理暂不支持。

Q: 如何处理非JSON响应？

A: 工具会自动尝试解析JSON。如果响应不是有效JSON，会返回错误信息和原始响应内容。

Q: 如何修改超时时间？

A: 在代码的axios配置中修改timeout参数，默认为30秒。

🛠️ 开发说明

项目结构

api-request-server/ ├── src/ │ └── index.ts # 主服务器文件 ├── build/ # 编译输出目录 ├── package.json # 项目配置 ├── tsconfig.json # TypeScript配置 └── README.md # 说明文档

本地开发

# 安装依赖 npm install # 开发构建 npm run build # 启动服务器测试 npm start

技术栈

Node.js: 运行环境
TypeScript: 类型安全的开发
Axios: HTTP请求库
@modelcontextprotocol/sdk: MCP协议实现

📄 许可证

MIT License - 详见LICENSE文件

🤝 贡献

欢迎提交Issue和Pull Request！

📞 支持

如果遇到问题，请：

检查配置文件路径是否正确
确认build目录下的index.js文件存在
查看Cline的输出日志
提交GitHub Issue

最后更新: 2025年12月3日

API Request MCP Server