Coucya MCP Server Requests

🚀 mcp-server-requests

mcp-server-requests 是一个 MCP 服务器，它提供了 HTTP 请求功能，允许大语言模型（LLM）抓取并处理网络内容，为 LLM 与网络数据的交互提供了便利。

🚀 快速开始

本项目可让大语言模型方便地进行网络内容的获取与处理，下面为你介绍其使用的基本流程。

✨ 主要特性

• 🌐 支持将网页内容转换为 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 服务器配置

你需要按照以下格式对 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. 具体工具说明

1. http_get

功能：执行 HTTP GET 请求。

参数：

• url（必需）：目标 URL 地址。
• query（可选）：查询参数的键值对，支持多个参数。
• headers（可选）：自定义请求头。

2. http_post

功能：执行 HTTP POST 请求。

参数：

• url（必需）：目标 URL 地址。
• query（可选）：查询参数的键值对，支持多个参数。
• headers（可选）：自定义请求头。
• data（可选）：请求体文本数据。
• json（可选）：请求体 JSON 数据。

3. http_put

功能：执行 HTTP PUT 请求。

参数：与 http_post 相同。

4. http_patch

功能：执行 HTTP PATCH 请求。

参数：与 http_post 相同。

5. http_delete

功能：执行 HTTP DELETE 请求。

参数：与 http_post 相同。

📄 许可证

本项目采用 MIT 许可证。