中文

---

mcp-server-requests

一个提供 HTTP 请求能力的 MCP 服务器，使 LLM 能够获取和处理 Web 内容。

特性

• 支持将 Web 内容转换为 Markdown 格式
• 支持过滤掉对 LLM 无用的内容
• 支持自定义 User-Agent 标头
• 支持随机 User-Agent 标头
• 支持在 HTTP 请求中自定义请求标头
• 支持完整的 HTTP 方法（GET、POST、PUT、DELETE、PATCH）
• LLM 可以访问完整的 HTTP 响应标头信息

安装

git clone https://github.com/coucya/mcp-server-requests.git
cd mcp-server-requests
pip install .

用法

MCP 服务器配置

{
    "mcpServers": {
        "mcp-server-requests": {
            "command": "python",
            "args": [
                "-m",
                "mcp_server_requests"
            ]
        }
    }
}

命令行

0. 启动 MCP 服务器

直接启动 MCP 服务器：

python -m mcp_server_requests

选项

• --user-agent TEXT: 指定自定义 User-Agent 字符串
• --random-user-agent [browser=xxx;os=xxx]: 使用随机生成的 User-Agent
• --force-user-agent: 强制使用命令行指定的 User-Agent，忽略 LLM 提供的 UA
• --list-os-and-browser: 列出可用于随机 User-Agent 生成的浏览器和操作系统

选项详情

• --user-agent 和 --random-user-agent 互斥，不能一起使用

• User-Agent 设置方法：

  • 自定义字符串：--user-agent "Mozilla/5.0 (...)"
  • 完全随机：--random-user-agent
  • 条件随机生成：
    • 指定浏览器类型：--random-user-agent browser=chrome
    • 指定操作系统：--random-user-agent os=windows
    • 同时指定浏览器和操作系统：--random-user-agent browser=chrome;os=windows
    • 注意：浏览器和操作系统参数不区分大小写

• 使用 --list-os-and-browser 查看可用于 --random-user-agent 的可用浏览器和操作系统。

• --force-user-agent 控制 User-Agent 优先级：

  • 启用时：优先使用命令行指定的 User-Agent（通过 --user-agent 或 --random-user-agent），忽略 LLM 提供的 UA
  • 禁用时：
    • 如果 LLM 提供 User-Agent，则使用该 User-Agent
    • 否则使用命令行指定的 User-Agent

---

1. fetch - 获取 Web 内容

fetch 子命令等同于 fetch 工具的功能，演示 fetch 能力。

python -m mcp_server_requests fetch <URL> [--return-content {raw,basic_clean,strict_clean,markdown}]

选项：

• --return-content: 返回内容类型（默认：markdown）
  • raw: 返回原始未处理的 HTML 内容
  • basic_clean: 基本清理，删除非显示标签，如 script、style
  • strict_clean: 严格清理，删除非显示标签和大多数 HTML 属性
  • markdown: 将 HTML 转换为干净的 Markdown 格式

示例：

python -m mcp_server_requests fetch https://example.com

---

2. get - 执行 HTTP GET 请求

get 子命令等同于 http_get 工具的功能，演示 http_get 能力。

python -m mcp_server_requests get <URL> [--headers HEADERS]

选项：

• --headers: 自定义请求标头（格式： "key1=value1;key2=value2"）

---

3. post - 执行 HTTP POST 请求

post 子命令等同于 http_post 工具的功能，演示 http_post 能力。

python -m mcp_server_requests post <URL> [--headers HEADERS] [--data TEXT]

选项：

• --headers: 自定义请求标头
• --data: 请求正文数据

---

4. put - 执行 HTTP PUT 请求

put 子命令等同于 http_put 工具的功能，演示 http_put 能力。

python -m mcp_server_requests put <URL> [--headers HEADERS] [--data TEXT]

选项：与 POST 方法相同

---

5. delete - 执行 HTTP DELETE 请求

delete 子命令等同于 http_delete 工具的功能，演示 http_delete 能力。

python -m mcp_server_requests delete <URL> [--headers HEADERS] [--data TEXT]

选项：与 POST 方法相同

---

功能

可用工具

1. fetch - 获取 Web 内容

   • 参数：
     • url (必需): 目标 URL
     • return_content (可选): 返回内容类型 ('raw', 'basic_clean', 'strict_clean', 'markdown')
       • raw: 返回原始 HTML 内容
       • basic_clean: 返回过滤后的 HTML 内容，删除非显示标签，如 script、style
       • strict_clean: 返回过滤后的 HTML 内容，删除非显示标签和大多数无用的 HTML 属性
       • markdown: 返回转换为 Markdown 的 HTML

2. http_get - 执行 HTTP GET 请求

   • 参数：
     • url (必需): 目标 URL
     • query (可选): 查询参数键值对
     • headers (可选): 自定义请求标头
       • LLM 可以在标头中指定 User-Agent，是否使用它由 --force-user-agent 控制（同样适用于其他工具）

3. http_post - 执行 HTTP POST 请求

   • 参数：
     • url (必需): 目标 URL
     • query (可选): 查询参数键值对
     • headers (可选): 自定义请求标头
     • data (可选): 请求正文数据（文本）
     • json (可选): 请求正文数据（JSON）
     • data 和 json 不能一起使用

4. http_put - 执行 HTTP PUT 请求

   • 参数：与 http_post 相同

5. http_patch - 执行 HTTP PATCH 请求

   • 参数：与 http_post 相同

6. http_delete - 执行 HTTP DELETE 请求

   • 参数：与 http_post 相同

许可证

MIT