Coucya MCP Server Requests

🚀 mcp-server-requests

mcp-server-requests 是一个 MCP 服务器，具备 HTTP 请求功能，可让大语言模型（LLM）抓取并处理网络内容，为网络数据获取和处理提供便利。

🚀 快速开始

mcp-server-requests 提供了便捷的 HTTP 请求功能，支持大语言模型（LLM）抓取和处理网络内容。以下为你介绍其快速使用方法。

✨ 主要特性

• 🌐 支持将网页内容转换为 Markdown 格式，方便后续处理。
• 🧹 支持过滤对 LLM 无用的内容，提高数据质量。
• 🆔 支持自定义 User - Agent 头，满足多样化需求。
• 🎲 支持随机生成的 User - Agent，增强请求的隐蔽性。
• 📄 支持自定义 HTTP 请求头，灵活定制请求。
• 🛠️ 支持完整的 HTTP 方法（GET、POST、PUT、DELETE、PATCH），满足各种业务场景。
• 📊 LLM 可以访问完整的 HTTP 响应头信息，获取更多数据。

📦 安装指南

你可以按照以下步骤安装 mcp-server-requests：

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

💻 使用示例

基础用法

MCP 服务器配置

你需要对 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（通过--user - agent），忽略 LLM 指定的 User - Agent，其他工具同理。
• --version：显示版本信息并退出。

1. 通用功能说明

所有工具均支持以下参数：

• 响应头控制：可以通过headers参数在请求中添加自定义头（例如：User - Agent、Authorization等）；LLM 可以通过headers指定User - Agent，是否使用由--force - user - agent决定。
• 请求体数据格式：支持两种数据格式，分别是data（文本形式的数据）和json（JSON 格式的数据），注意data和json不能同时使用。

2. 具体工具说明

• http_get：执行 HTTP GET 请求。
  • 参数：
    • url（必需）：目标 URL 地址。
    • query（可选）：查询参数的键值对，支持多个参数。
    • headers（可选）：自定义请求头。
• http_post：执行 HTTP POST 请求。
  • 参数：
    • url（必需）：目标 URL 地址。
    • query（可选）：查询参数的键值对，支持多个参数。
    • headers（可选）：自定义请求头。
    • data（可选）：请求体文本数据。
    • json（可选）：请求体 JSON 数据。
• http_put：执行 HTTP PUT 请求，参数与http_post相同。
• http_patch：执行 HTTP PATCH 请求，参数与http_post相同。
• http_delete：执行 HTTP DELETE 请求，参数与http_post相同。

📄 许可证

本项目采用 MIT 许可证。