Skip to main content
Glama
mcp-server-requests

mcp-server-requests

by coucya

중국어


mcp-서버-요청

LLM이 웹 콘텐츠를 가져와 처리할 수 있도록 HTTP 요청 기능을 제공하는 MCP 서버입니다.

특징

  • 웹 콘텐츠를 Markdown 형식으로 변환하는 기능을 지원합니다.

  • LLM에 쓸모없는 콘텐츠 필터링 지원

  • 사용자 정의 User-Agent 헤더를 지원합니다.

  • 임의의 User-Agent 헤더를 지원합니다.

  • HTTP 요청에서 사용자 정의 요청 헤더를 지원합니다.

  • 전체 HTTP 메서드(GET, POST, PUT, DELETE, PATCH)를 지원합니다.

  • LLM은 전체 HTTP 응답 헤더 정보에 액세스할 수 있습니다.

Related MCP server: cURL MCP Server

설치

지엑스피1

용법

MCP 서버 구성

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

명령줄

0. MCP 서버 시작

MCP 서버를 직접 시작합니다.

python -m mcp_server_requests

옵션

  • --user-agent TEXT : 사용자 정의 사용자 에이전트 문자열 지정

  • --random-user-agent [browser=xxx;os=xxx] : 무작위로 생성된 User-Agent를 사용합니다.

  • --force-user-agent : LLM에서 제공한 UA를 무시하고 명령줄에서 지정된 User-Agent를 사용하여 강제 실행합니다.

  • --list-os-and-browser : 임의의 사용자 에이전트 생성을 위해 사용 가능한 브라우저와 OS를 나열합니다.

옵션 세부 정보

  • --user-agent 와 --random-user-agent 상호 배타적이며 함께 사용할 수 없습니다.

  • 사용자 에이전트 설정 방법:

    • 사용자 정의 문자열: --user-agent "Mozilla/5.0 (...)"

    • 완전 무작위: --random-user-agent

    • 조건부 난수 생성:

      • 브라우저 유형을 지정하세요: --random-user-agent browser=chrome

      • OS 지정: --random-user-agent os=windows

      • 브라우저와 OS 모두: --random-user-agent browser=chrome;os=windows

      • 참고: 브라우저 및 OS 매개변수는 대소문자를 구분하지 않습니다.

  • --random-user-agent 에 사용할 수 있는 브라우저와 OS를 보려면 --list-os-and-browser 사용하세요.

  • --force-user-agent 사용자 에이전트 우선순위를 제어합니다.

    • 활성화 시: --user-agent 또는 --random-user-agent 통해 명령줄에서 지정된 사용자 에이전트를 우선시하고 LLM에서 제공하는 UA는 무시합니다.

    • 비활성화 시:

      • LLM이 User-Agent를 제공하는 경우 해당 항목을 사용하세요.

      • 그렇지 않으면 명령줄에 지정된 User-Agent를 사용합니다.


1. fetch - 웹 콘텐츠 가져오기

fetch 하위 명령은 fetch 도구 기능과 동일하며 fetch 기능을 보여줍니다.

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

옵션:

  • --return-content : 콘텐츠 유형을 반환합니다(기본값: 마크다운)

    • raw : 처리되지 않은 원시 HTML 콘텐츠를 반환합니다.

    • basic_clean : 스크립트, 스타일과 같은 표시되지 않는 태그를 제거하는 기본 정리

    • strict_clean : 비표시 태그와 대부분의 HTML 속성을 제거하는 엄격한 정리

    • 마크다운 : HTML을 깔끔한 마크다운 형식으로 변환

예:

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 - 웹 콘텐츠 가져오기

    • 매개변수:

      • url (필수): 대상 URL

      • return_content (선택 사항): 콘텐츠 유형('raw', 'basic_clean', 'strict_clean', 'markdown')을 반환합니다.

        • raw : 원시 HTML 콘텐츠를 반환합니다.

        • basic_clean : 스크립트, 스타일과 같은 표시되지 않는 태그를 제거하여 필터링된 HTML 콘텐츠를 반환합니다.

        • strict_clean : 필터링된 HTML 콘텐츠를 반환하고, 표시되지 않는 태그와 대부분의 쓸모없는 HTML 속성을 제거합니다.

        • markdown : HTML을 Markdown으로 변환하여 반환합니다.

  2. http_get - HTTP GET 요청 실행

    • 매개변수:

      • url (필수): 대상 URL

      • 쿼리 (선택 사항): 쿼리 매개변수 키-값 쌍

      • 헤더 (선택 사항): 사용자 정의 요청 헤더

        • LLM은 헤더에 User-Agent를 지정할 수 있으며, 이를 사용할지 여부는 --force-user-agent 로 제어됩니다(다른 도구에도 동일하게 적용됨).

  3. http_post - HTTP POST 요청 실행

    • 매개변수:

      • url (필수): 대상 URL

      • 쿼리 (선택 사항): 쿼리 매개변수 키-값 쌍

      • 헤더 (선택 사항): 사용자 정의 요청 헤더

      • 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

Available Tools

3 tools
fetchA

Fetch web page content

Function/Features:

  • Retrieves web page content from any HTTP/HTTPS URL

Args: url (str): The URL to fetch content from. return_content ('raw' | 'basic_clean' | 'strict_clean' | 'markdown', optional): Processing format for HTML content. Defaults to "markdown". - "raw": Returns unmodified HTML content with full response headers - "basic_clean": Removes non-displaying tags (script, style, meta, etc.) while preserving structure - "strict_clean": Removes non-displaying tags and most HTML attributes, keeping only essential structure - "markdown": Converts HTML content to clean, readable Markdown format

Examples: // Returns content as markdown fetch({url: "https://example.com"})

// Returns raw HTML content
fetch({url: "https://api.example.com/data", return_content: "raw"})  

Inputs: url (required), return_content. Returns: result

fetch_to_fileA

Fetch web content and save it to a file in the workspace

Function/Features:

  • Retrieves web content from any HTTP/HTTPS URL and saves it to a file

  • Automatic directory creation for nested file paths

Notes:

  • Automatically creates parent directories if they don't exist

  • Uses UTF-8 encoding for all saved files

  • parameter file_path must be a absolute path

Args: url (str): The URL to fetch content from. file_path (str): File path where the content will be saved. return_content ('raw' | 'basic_clean' | 'strict_clean' | 'markdown'], optional): Processing format for HTML content. Defaults to "markdown". - "raw": Saves unmodified HTML content - "basic_clean": Saves HTML with non-displaying tags removed (script, style, etc.) while preserving structure - "strict_clean": Saves HTML with non-displaying tags and most HTML attributes removed, keeping only essential structure - "markdown": Converts HTML content to clean, readable Markdown format before saving

Examples: // Save web page as markdown fetch_to_file({url: "https://example.com", file_path: "/home/user/content/example.md"})

// Save raw HTML content
fetch_to_file({url: "https://api.example.com/data", file_path: "C:\data\response.html", return_content: "raw"})

// Save cleaned content
fetch_to_file({url: "https://example.com/docs", file_path: "/tmp/docs/cleaned.html", return_content: "strict_clean"})

Inputs: url (required), file_path (required), return_content. Returns: result

http_requestA

Execute an HTTP request with the specified method

Function/Features:

  • Sends HTTP requests using any standard method (GET, POST, PUT, PATCH, DELETE)

  • Allows custom HTTP headers

  • Returns complete HTTP response including status, headers, and body

Notes:

  • 'data' and 'json' parameters are mutually exclusive - use only one

  • When using 'json', the Content-Type header is automatically set to 'application/json'

  • When using 'data', you may need to set appropriate Content-Type header manually

  • Query parameters are URL-encoded automatically and appended to the URL

  • The response includes the full HTTP response with status line, all headers, and body

Args: url (str): Target URL for the HTTP request. method ('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'], optional): HTTP method to use. Defaults to "GET". query ({ [string]: string | number }, optional): Query parameters to append to the URL. Values are automatically converted to strings. Example: {'key1': 'value1', 'key2': 2}, becomes "key1=value1&key2=2" appended to the URL. headers ({ [string]: string }, optional): Custom HTTP request headers. data (str, optional): Text data to send in the request body. Cannot be used with 'json'. json (Any JSON, optional): Data to serialize as JSON and send in the request body. Cannot be used with 'data'.

Examples: // GET request (default method) http_request({url: "https://api.example.com/data"})

// GET request with query parameters
http_request({url: "https://api.example.com/search", query: {"q": "test", "limit": 10}})

// POST request with JSON data
http_request({url: "https://api.example.com/users", method: "POST", json: {"name": "John", "age": 30}})

// POST request with raw text data
http_request({url: "https://api.example.com/log", method: "POST", data: "This is a log message"})

// PUT request
http_request({url: "https://api.example.com/users/123", method: "PUT", json: {"name": "John Updated", "age": 31}})

// PATCH request
http_request({url: "https://api.example.com/users/123", method: "PATCH", json: {"age": 31, "email": "new@example.com"}})

// DELETE request
http_request({url: "https://api.example.com/users/123", method: "DELETE"})

// Request with custom headers
http_request({url: "https://api.example.com/secure", method: "POST", headers: {"Authorization": "Bearer token"}, json: {"key": "value"}})

Inputs: url (required), method (required), query (required), headers (required), +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct purposes with no overlap. 'fetch' retrieves web content for immediate use, 'fetch_to_file' saves web content to a file, and 'http_request' handles general HTTP requests with full control over methods and parameters. Each tool serves a unique function in the web request workflow.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with clear verb-action structure. 'fetch', 'fetch_to_file', and 'http_request' all use descriptive verbs that accurately reflect their functionality, maintaining excellent naming consistency throughout the toolset.

    Tool Count4/5

    Three tools is reasonable for a web requests server, though slightly minimal. The tools cover the core use cases well, but the count feels slightly lean for a server that could potentially benefit from additional specialized tools like websocket handling or streaming responses.

    Completeness5/5

    The toolset provides comprehensive coverage for web request operations. It includes content fetching with processing options, file-based fetching, and a full-featured HTTP client supporting all major methods, headers, and data formats. No obvious gaps exist for a general-purpose web requests server.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      F
      maintenance
      Enables LLMs to retrieve and process web content by fetching URLs and converting HTML to markdown, with support for chunked reading and customizable user-agents.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables LLMs to make HTTP requests using structured cURL commands with support for multiple authentication methods, custom headers, and comprehensive request/response control.
      2
      8 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables LLMs to fetch and extract web content using browser automation, OCR, and multiple extraction methods, handling JavaScript rendering and anti-scraping techniques.
      17
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLMs to make HTTP requests with OAuth2, session cookies, retry logic, and cURL command generation, while providing security features like SSRF protection and TLS enforcement.
      1
      MIT