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
}

🔧 高级配置

代理配置优先级

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

超时设置

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

timeout: 30000, // 30秒

❓ 常见问题

Q: 为什么无法选中autoApprove？

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

Q: 如何配置代理？

A: 有两种方式：

1. 在MCP配置的env中设置HTTP_PROXY和HTTPS_PROXY
2. 在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！

📞 支持

如果遇到问题，请：

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

---

最后更新: 2025年12月3日