AI导哈

HTTP请求执行工具

基于TypeScript的MCP服务器，提供灵活的HTTP请求执行功能，支持自定义方法、头部和内容，适用于AI助手与Web API的无缝交互。

  • by KS-GEN-AI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 KS-GEN-AI/Web-Request-MCP-Server

使用说明

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许可证-有关详细信息，请参阅许可证文件

相关 MCP