mcp-server-requests
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_requestsOpciones
--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-agenty--random-user-agentson mutuamente excluyentes y no se pueden usar juntosMétodos de configuración del agente de usuario:
Cadena personalizada:
--user-agent "Mozilla/5.0 (...)"Completamente aleatorio:
--random-user-agentGeneración aleatoria condicional:
Especifique el tipo de navegador:
--random-user-agent browser=chromeEspecifique el sistema operativo:
--random-user-agent os=windowsTanto el navegador como el sistema operativo:
--random-user-agent browser=chrome;os=windowsNota: Los parámetros del navegador y del sistema operativo no distinguen entre mayúsculas y minúsculas.
Utilice
--list-os-and-browserpara ver los navegadores y sistemas operativos disponibles para--random-user-agent.--force-user-agentcontrola 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-agento--random-user-agent), ignorando el UA proporcionado por LLMCuando 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.com2. 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
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
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)
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
http_put - Ejecutar solicitud HTTP PUT
Parámetros: Igual que http_post
http_patch - Ejecutar solicitud HTTP PATCH
Parámetros: Igual que http_post
http_delete - Ejecutar solicitud HTTP DELETE
Parámetros: Igual que http_post
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Available Tools
3 toolsfetchA
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_pathmust 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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Web tools for AI agents: URL to clean Markdown, site crawl, screenshots, PDF/Office to text, OCR.
Web data for agents: YouTube transcripts, screenshots, Google News, WHOIS, jobs, tech stack, more.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
Related MCP Servers
- AlicenseCqualityFmaintenanceEnables LLMs to retrieve and process web content by fetching URLs and converting HTML to markdown, with support for chunked reading and customizable user-agents.1MIT
- AlicenseAqualityBmaintenanceEnables LLMs to make HTTP requests using structured cURL commands with support for multiple authentication methods, custom headers, and comprehensive request/response control.28 npm4MIT
- AlicenseNot gradedqualityCmaintenanceEnables LLMs to fetch and extract web content using browser automation, OCR, and multiple extraction methods, handling JavaScript rendering and anti-scraping techniques.17MIT
- AlicenseAqualityCmaintenanceEnables 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.1MIT