Skip to main content
Glama
mcp-server-requests

mcp-server-requests

by coucya

Chino


solicitudes del servidor mcp

Un servidor MCP que proporciona capacidades de solicitud HTTP, lo que permite a los LLM obtener y procesar contenido web.

Características

  • Admite la conversión de contenido web al formato Markdown

  • Admite el filtrado de contenido inútil para los LLM

  • Admite encabezados de agente de usuario personalizados

  • Admite encabezados de agente de usuario aleatorios

  • Admite encabezados de solicitud personalizados en solicitudes HTTP

  • Admite métodos HTTP completos (GET, POST, PUT, DELETE, PATCH)

  • Los LLM pueden acceder a la información completa del encabezado de respuesta HTTP

Related MCP server: cURL MCP Server

Instalación

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

Uso

Configuración del servidor MCP

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

Línea de comandos

0. Iniciar el servidor MCP

Inicie el servidor MCP directamente:

python -m mcp_server_requests

Opciones

  • --user-agent TEXT : Especifica una cadena de agente de usuario personalizada

  • --random-user-agent [browser=xxx;os=xxx] : Utiliza un agente de usuario generado aleatoriamente

  • --force-user-agent : Fuerza el uso del agente de usuario especificado por la línea de comandos, ignorando el UA proporcionado por LLM

  • --list-os-and-browser : enumera los navegadores y sistemas operativos disponibles para la generación aleatoria de agentes de usuario

Detalles de la opción

  • --user-agent y --random-user-agent son mutuamente excluyentes y no se pueden usar juntos

  • Métodos de configuración del agente de usuario:

    • Cadena personalizada: --user-agent "Mozilla/5.0 (...)"

    • Completamente aleatorio: --random-user-agent

    • Generación aleatoria condicional:

      • Especifique el tipo de navegador: --random-user-agent browser=chrome

      • Especifique el sistema operativo: --random-user-agent os=windows

      • Tanto el navegador como el sistema operativo: --random-user-agent browser=chrome;os=windows

      • Nota: Los parámetros del navegador y del sistema operativo no distinguen entre mayúsculas y minúsculas.

  • Utilice --list-os-and-browser para ver los navegadores y sistemas operativos disponibles para --random-user-agent .

  • --force-user-agent controla la prioridad del agente de usuario:

    • Cuando está habilitado: prioriza el agente de usuario especificado en la línea de comandos (a través de --user-agent o --random-user-agent ), ignorando el UA proporcionado por LLM

    • Cuando está deshabilitado:

      • Si LLM proporciona un agente de usuario, úselo

      • De lo contrario, utilice la línea de comandos especificada por el agente de usuario.


1. fetch - Obtener contenido web

El subcomando fetch es equivalente a la funcionalidad de la herramienta fetch y demuestra las capacidades de búsqueda.

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

Opciones:

  • --return-content : Tipo de contenido de retorno (predeterminado: markdown)

    • raw : Devuelve contenido HTML sin procesar

    • basic_clean : Limpieza básica, eliminando etiquetas que no se muestran, como script y estilo.

    • strict_clean : Limpieza estricta, eliminando etiquetas que no se muestran y la mayoría de los atributos HTML

    • Markdown : convierte HTML a formato Markdown limpio

Ejemplo:

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

2. get - Ejecutar solicitud HTTP GET

El subcomando get es equivalente a la funcionalidad de la herramienta http_get, demostrando las capacidades de http_get.

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

Opciones:

  • --headers : Encabezados de solicitud personalizados (formato: "clave1=valor1;clave2=valor2")


3. post - Ejecutar solicitud HTTP POST

El subcomando post es equivalente a la funcionalidad de la herramienta http_post, demostrando las capacidades de http_post.

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

Opciones:

  • --headers : encabezados de solicitud personalizados

  • --data : Datos del cuerpo de la solicitud


4. put - Ejecutar solicitud HTTP PUT

El subcomando put es equivalente a la funcionalidad de la herramienta http_put, demostrando las capacidades de http_put.

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

Opciones: Igual que el método POST


5. eliminar - Ejecutar solicitud HTTP DELETE

El subcomando eliminar es equivalente a la funcionalidad de la herramienta http_delete, lo que demuestra las capacidades de http_delete.

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

Opciones: Igual que el método POST


Funcionalidad

Herramientas disponibles

  1. fetch - Obtener contenido web

    • Parámetros:

      • URL (obligatorio): URL de destino

      • return_content (opcional): Tipo de contenido de retorno ('raw', 'basic_clean', 'strict_clean', 'markdown')

        • raw : Devuelve contenido HTML sin procesar

        • basic_clean : Devuelve contenido HTML filtrado, eliminando etiquetas que no se muestran, como script y estilo.

        • strict_clean : Devuelve contenido HTML filtrado, eliminando las etiquetas que no se muestran y la mayoría de los atributos HTML inútiles

        • markdown : Devuelve HTML convertido a Markdown

  2. http_get - Ejecutar solicitud HTTP GET

    • Parámetros:

      • URL (obligatorio): URL de destino

      • consulta (opcional): pares clave-valor de parámetros de consulta

      • encabezados (opcionales): encabezados de solicitud personalizados

        • LLM puede especificar User-Agent en los encabezados; si se usa o no se controla mediante --force-user-agent (lo mismo se aplica a otras herramientas)

  3. http_post - Ejecutar solicitud HTTP POST

    • Parámetros:

      • URL (obligatorio): URL de destino

      • consulta (opcional): pares clave-valor de parámetros de consulta

      • encabezados (opcionales): encabezados de solicitud personalizados

      • datos (opcional): Datos del cuerpo de la solicitud (texto)

      • json (opcional): datos del cuerpo de la solicitud (JSON)

      • Los datos y JSON no se pueden usar juntos

  4. http_put - Ejecutar solicitud HTTP PUT

    • Parámetros: Igual que http_post

  5. http_patch - Ejecutar solicitud HTTP PATCH

    • Parámetros: Igual que http_post

  6. http_delete - Ejecutar solicitud HTTP DELETE

    • Parámetros: Igual que http_post

Licencia

Instituto Tecnológico de Massachusetts (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