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.