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:

Related MCP server: MCP Unified Server

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

1. Instala Docker si aún no lo has hecho

2. 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.

3. 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

1. 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 .

2. Crear y activar un entorno virtual:

   uv venv
   source .venv/bin/activate  # Linux/macOS
   # or
   .venv\Scripts\activate     # Windows

3. Instalar dependencias desde el archivo de bloqueo:

   uv sync

4. 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"

5. 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:

📚 Conozca más sobre MCP

Aquí hay algunos recursos para comenzar:

• Especificación MCP

• SDK de Python para MCP

• Servidores de ejemplo MCP

📄 Licencia

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