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 許可證。