Skip to main content
Glama
MCP-RQuest
by xxxbrian

solicitud mcp

Versión de PyPI Versiones de Python Estrellas de GitHub Licencia

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades avanzadas de solicitud HTTP para Claude y otros LLM. Desarrollado sobre rquest , este servidor permite una emulación realista del navegador con huellas digitales TLS/JA3/JA4 precisas, lo que permite a los modelos interactuar con sitios web de forma más natural y evitar las medidas anti-bots habituales. También admite la conversión de documentos PDF y HTML a Markdown para facilitar su procesamiento por parte de los LLM.

Características

  • Métodos HTTP completos : compatibilidad con GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS y TRACE

  • Huellas digitales del navegador : huellas digitales precisas de navegadores TLS, JA3/JA4 y HTTP/2

  • Manejo de contenido :

    • Manejo automático de respuestas grandes con conteo de tokens

    • Conversión de HTML a Markdown para un mejor procesamiento de LLM

    • Conversión de PDF a Markdown mediante la biblioteca Marker

    • Almacenamiento seguro de respuestas en directorios temporales del sistema

  • Soporte de autenticación : métodos de autenticación básicos, de portador y personalizados

  • Solicitar personalización :

    • Encabezados, cookies, redirecciones

    • Datos de formulario, cargas útiles JSON, multipart/form-data

    • Parámetros de consulta

  • Seguridad SSL : utiliza BoringSSL para conexiones seguras con huellas dactilares del navegador realistas

Related MCP server: URL Fetch MCP

Herramientas disponibles

  • Herramientas de solicitud HTTP :

    • http_get - Realizar solicitudes GET con parámetros opcionales

    • http_post - Enviar datos mediante solicitudes POST

    • http_put - Actualizar recursos con solicitudes PUT

    • http_delete - Eliminar recursos con solicitudes DELETE

    • http_patch - Actualizar parcialmente los recursos

    • http_head - Recuperar solo los encabezados de un recurso

    • http_options - Recuperar opciones para un recurso

    • http_trace - Seguimiento de solicitudes de diagnóstico

  • Herramientas de manejo de respuestas :

    • get_stored_response - Recupera respuestas grandes almacenadas, opcionalmente por rango de línea

    • get_stored_response_with_markdown : convierte respuestas HTML o PDF al formato Markdown para un mejor procesamiento de LLM

    • get_model_state - Obtener el estado actual del proceso de carga de modelos PDF

    • restart_model_loading - Reinicia el proceso de carga de modelos PDF si falló o se atascó

Soporte para PDF

mcp-rquest ahora admite la conversión de PDF a Markdown, lo que le permite descargar archivos PDF y convertirlos a un formato Markdown que es fácil de procesar para los LLM:

  1. Detección automática de PDF : los archivos PDF se detectan automáticamente según el tipo de contenido

  2. Conversión perfecta : la misma herramienta get_stored_response_with_markdown funciona tanto para archivos HTML como PDF

  3. Conversión de alta calidad : utiliza la biblioteca de marcadores para una transformación precisa de PDF a Markdown

  4. Rendimiento optimizado : los modelos se descargan previamente durante la instalación del paquete para evitar demoras durante el procesamiento de la solicitud.

Instalación

Uso de uv (recomendado)

Al usar uv no se requiere ninguna instalación específica. Usaremos uvx para ejecutar mcp-rquest directamente.

Usando pip

Alternativamente, puede instalar mcp-rquest a través de pip:

pip install mcp-rquest

Después de la instalación, puedes ejecutarlo como un script usando:

python -m mcp_rquest

Configuración

Configurar para Claude.app

Añade a tu configuración de Claude:

Usando uvx :

{
  "mcpServers": {
    "http-rquest": {
      "command": "uvx",
      "args": ["mcp-rquest"]
    }
  }
}

Usando pip :

{
  "mcpServers": {
    "http-rquest": {
      "command": "python",
      "args": ["-m", "mcp_rquest"]
    }
  }
}

Usando pipx :

{
  "mcpServers": {
    "http-rquest": {
      "command": "pipx",
      "args": ["run", "mcp-rquest"]
    }
  }
}

Emulación del navegador

mcp-rquest aprovecha las potentes funciones de emulación de navegador de rquest para proporcionar huellas dactilares realistas, lo que ayuda a evitar la detección de bots y a acceder a contenido que normalmente solo está disponible en navegadores estándar. Las huellas dactilares de navegador compatibles incluyen:

  • Chrome (varias versiones)

  • Firefox

  • Safari (incluidas las versiones para iOS y iPad)

  • Borde

  • OkHttp

Esto garantiza que las solicitudes enviadas a través de mcp-rquest aparezcan como tráfico legítimo del navegador en lugar de solicitudes de bots.

Desarrollo

Configuración de un entorno de desarrollo

  1. Clonar el repositorio

  2. Crea un entorno virtual usando uv:

    uv venv
  3. Activar el entorno virtual:

    # Unix/macOS
    source .venv/bin/activate
    # Windows
    .venv\Scripts\activate
  4. Instalar dependencias de desarrollo:

    uv pip install -e ".[dev]"

Expresiones de gratitud

  • Este proyecto está construido sobre rquest , que proporciona al cliente HTTP avanzado capacidades de toma de huellas dactilares del navegador.

  • rquest se basa en una bifurcación de reqwest .

Available Tools

12 tools
get_model_stateB

Get the current state of the PDF models(used by get_stored_response_with_markdown) loading process

Inputs: no named parameters.

get_stored_responseC

Retrieve a stored HTTP response by its ID

Inputs: response_id (required), end_line, start_line.

get_stored_response_with_markdownA

Retrieve a stored HTTP response by its ID and convert it to Markdown format. Supports HTML and PDF content types. (Converting large PDF to Markdown may cause timeout, just wait and try again.)

Inputs: response_id (required).

http_deleteC

Make an HTTP DELETE request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_getC

Make an HTTP GET request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_headC

Make an HTTP HEAD request to retrieve only headers from the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_optionsC

Make an HTTP OPTIONS request to retrieve options for the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_patchA

Make an HTTP PATCH request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_postC

Make an HTTP POST request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_putC

Make an HTTP PUT request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_traceA

Make an HTTP TRACE request for diagnostic tracing of the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

restart_model_loadingA

Restart the PDF models(used by get_stored_response_with_markdown) loading process if it failed or got stuck

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 12 tools

    Disambiguation4/5

    The HTTP method tools are clearly distinct, and the two stored response tools are differentiated by markdown conversion. However, get_stored_response and get_stored_response_with_markdown could be confused by an agent without careful reading, but descriptions mitigate ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern, with http_ prefix for HTTP methods and clear action words like get, restart, and retrieve. The naming is highly predictable and uniform.

    Tool Count5/5

    12 tools is well-scoped for an HTTP client with model management and stored response retrieval. Each tool has a clear purpose, and the count is neither sparse nor overwhelming.

    Completeness4/5

    The HTTP methods cover all standard request types, and stored response handling is present. Minor gaps include no tool to clear or list stored responses, and model state tools are limited to get and restart, but core functionality is complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
      7
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
      3
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides enhanced browser automation capabilities using Puppeteer-Extra with Stealth Plugin, enabling LLMs to interact with web pages in a way that better emulates human behavior and avoids detection as automation.
      3
      MIT