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?

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.

Related MCP server: MCP Python Toolbox

🏎️¿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.