Integrations

Allows converting web pages to markdown format for easier reading and processing by AI assistants
Integrates with SearXNG's search API to provide web search functionality, enabling current information retrieval, specific resource discovery, and calculations

Servidor MCP

Dale a tus asistentes de IA la capacidad de ayudarte de forma más eficaz. Este servidor les permite acceder a sitios web y buscar en la web de forma segura, con información clara sobre lo que sucede y mensajes de error útiles cuando algo falla.

🛠️ ¿Qué herramientas ofrece este servidor?
🏎️¿Cómo puedo ejecutarlo?
- 🐋 Usando Docker (recomendado)
- 💻 Corriendo localmente
🔌 Cómo conectarse
📚 Conozca más sobre MCP
📄 Licencia

🛠️ ¿Qué herramientas ofrece este servidor?

El servidor proporciona dos herramientas potentes que ayudan a los asistentes de IA a resolver problemas del mundo real:

Herramienta	Lo que puede hacer
Buscar	Busque en la web a través de SearXNG para obtener información actual, recursos específicos o para realizar cálculos.
Web	Accede a sitios web y procesa su contenido. Puedes convertir páginas a Markdown para facilitar su lectura, obtener el contenido original o extraer enlaces.

🏎️¿Cómo puedo ejecutarlo?

🐋 Usando Docker (recomendado)

El servidor se ejecuta en contenedores Docker para garantizar la seguridad y la simplicidad. Para empezar, sigue estos pasos:

Instala Docker si aún no lo has hecho
Crea un archivo llamado docker-compose.yml con:
services: mcp-server: environment: # Required: URL for your SearXNG instance's Search API - SEARXNG_QUERY_URL=http://searxng:8080 # Optional: Configure network mode (SSE) for LibreChat etc. - SSE_HOST=0.0.0.0 - SSE_PORT=8080 # Optional: Set a custom User-Agent for web requests - USER_AGENT=MCP-Server/1.0 (github.com/tcpipuk/mcp-server) image: ghcr.io/tcpipuk/mcp-server/server:latest ports: # Only needed if using SSE_HOST/SSE_PORT - "8080:8080" # Expose port 8080 on host restart: unless-stopped stop_grace_period: 1s # Example SearXNG service (optional, adapt as needed) # searxng: # environment: # - SEARXNG_BASE_URL=http://searxng:8080 # Ensure SearXNG knows its own URL # image: searxng/searxng:latest # restart: unless-stopped # volumes: # - ./searxng:/etc/searxng:rw
Importante : debe proporcionar la variable de entorno SEARXNG_QUERY_URL , que apunta al punto final de la API de búsqueda de su instancia SearXNG (generalmente termina en / o /search ).
La configuración de SSE_HOST y SSE_PORT habilita el modo de red (Eventos enviados por el servidor), recomendado para configuraciones multicontenedor como LibreChat. Si se omite, el servidor utiliza E/S estándar.
Ejecute docker compose up -d para iniciar el contenedor del servidor (y opcionalmente SearXNG).

La mayoría de la gente usa esto con:

Claude Desktop : se conecta directamente a través de stdio (omite SSE_HOST / SSE_PORT en docker-compose.yml ).
LibreChat : se conecta a través de la red mediante SSE.

Para LibreChat, agregue esto a su librechat.yaml (asumiendo SSE_PORT=8080 ):

mcpServers:
  mcp-server:
    iconPath: "/path/to/icon.png" # Optional: Custom icon
    label: "MCP Web/Search" # Optional: Custom label shown in UI
    type: sse
    url: http://mcp-server:8080/sse # Adjust host/port if needed

💻 Corriendo localmente

Instalar uv (requiere Python 3.13+):
curl -LsSf https://astral.sh/uv/install.sh | sh
Nota: Si ya tiene uv instalado, actualícelo con uv self update .
Crear y activar un entorno virtual:
uv venv source .venv/bin/activate # Linux/macOS # or .venv\Scripts\activate # Windows
Instalar dependencias desde el archivo de bloqueo:
uv sync
Establecer las variables de entorno requeridas:
# Required: URL for your SearXNG instance's Search API export SEARXNG_QUERY_URL="http://your-searxng-instance.local:8080" # Optional: Custom User-Agent export USER_AGENT="CustomAgent/1.0"
Ejecutar el servidor:
# For network (SSE) mode (e.g., for LibreChat) mcp-server --sse-host 0.0.0.0 --sse-port 3001 # For direct stdio mode (e.g., for Claude Desktop) mcp-server

Argumentos disponibles:

--sse-host : dirección de escucha SSE (p. ej., 0.0.0.0 ). Habilita el modo SSE.
--sse-port : puerto de escucha SSE (p. ej., 3001 ). Habilita el modo SSE.
--user-agent : cadena de agente de usuario personalizada (anula la variable de entorno USER_AGENT ).

Nota : Si no se proporcionan las variables de --sse-host ni --sse-port (y no se configuran las variables de entorno SSE_HOST / SSE_PORT ), el servidor pasa al modo stdio de forma predeterminada. La variable de entorno SEARXNG_QUERY_URL siempre es obligatoria.

🔌 Cómo conectarse

Puedes conectarte al servidor de dos maneras:

Método	Qué significa	Cuándo usarlo
Conexión de red (SSE)	El servidor escucha en un puerto de red en busca de conexiones.	Ideal para LibreChat u otros clientes en red.
Conexión directa (stdio)	El servidor se comunica directamente a través de entrada/salida estándar.	Útil para pruebas locales o Claude Desktop.

📚 Conozca más sobre MCP

Aquí hay algunos recursos para comenzar:

📄 Licencia

Este proyecto está licenciado bajo la GPLv3. Consulte el archivo de LICENCIA para obtener más información.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor que permite a los asistentes de IA como Claude ejecutar código Python y acceder a sitios web de forma segura, procesando datos para una mejor comprensión de la IA y proporcionando mensajes de error útiles.

MCP Server