MCP Server

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:

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

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