Web请求MCP服务器
通过MCP(模型上下文协议)执行HTTP请求
这是一个基于TypeScript的MCP服务器,它提供了一个灵活的工具来执行具有自定义方法、标头和正文内容的HTTP请求。它使AI助手能够与web API和端点无缝交互。
特性
http_request
一个多功能的工具,用于发出HTTP请求,并完全控制所有参数。
- 目的:使用自定义配置执行HTTP请求
- 参数:
- url (必填):目标URL(例如,“https://api.example.com/endpoint") - method (可选):HTTP方法-GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS(默认为GET) - headers (可选):自定义标头作为键值对 - body (可选):请求正文(字符串或对象,对象自动JSON字符串化) - params (可选):URL查询参数作为键值对
- 行为:
- JSON正文的自动内容类型检测 - 大响应的响应截断(最多50000个字符) - 使用状态代码进行全面的错误处理 - 返回完整的响应,包括状态、标头和数据
请求示例:
// Simple GET request
{ url: "https://api.github.com/users/octocat" }
// POST with JSON body
{
url: "https://api.example.com/data",
method: "POST",
headers: { "Authorization": "Bearer token123" },
body: { name: "John", email: "john@example.com" }
}
// GET with query parameters
{
url: "https://api.example.com/search",
params: { q: "search term", limit: "10" }
}发展
安装依赖项:
npm install构建服务器:
npm run build对于自动重建的开发:
npm run watch安装
与Claude Desktop一起使用
要与Claude Desktop一起使用,请添加服务器配置:
在MacOS上: ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"webrequest": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
}
}
}与光标一起使用
添加到光标MCP设置配置文件中:
{
"mcpServers": {
"webrequest": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
}
}
}调试
由于MCP服务器通过stdio进行通信,调试可能具有挑战性。我们建议使用 MCP检查员:
npm run inspector检查器将提供一个URL,用于访问浏览器中的调试工具。
配置
服务器配置:
- 最大响应大小:50000个字符(大于此值的响应将被截断)
- 支持的方法:获取、发布、放置、删除、补丁、头部、选项
- 内容类型:自动JSON处理,通过标头支持任何内容类型
用例
此MCP服务器可用于:
- 测试和与REST API交互
- 从web服务获取数据
- 在AI工作流中自动化HTTP请求
- 原型API集成
- 调试web端点
许可证
MIT许可证-有关详细信息,请参阅许可证文件
