mcp-server-requests

by coucya
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables conversion of web pages to Markdown format, allowing for cleaner and more readable text representation of online content.

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

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)

-
security - not tested
A
license - permissive license
-
quality - not tested

Recuperación de contenido web (página web completa, contenido filtrado o convertido a Markdown), agente de usuario personalizado, compatibilidad con métodos multi-HTTP (GET/POST/PUT/DELETE/PATCH), encabezados de solicitud controlados por LLM, encabezados de respuesta accesibles por LLM y más.

  1. Features
    1. Installation
      1. Usage
        1. MCP Server Configuration
        2. Command Line
        3. 0. Start MCP Server
        4. 1. fetch - Fetch Web Content
        5. 2. get - Execute HTTP GET Request
        6. 3. post - Execute HTTP POST Request
        7. 4. put - Execute HTTP PUT Request
        8. 5. delete - Execute HTTP DELETE Request
      2. Functionality
        1. Available Tools
      3. License
        ID: 7cy501fadq