MCP Web Search Server

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de búsqueda web, desplegable en Render.

Construido con Python usando el SDK oficial de MCP, con soporte para transporte SSE (Server-Sent Events) para máxima compatibilidad con clientes MCP como AIPI, Claude Desktop y otros.

Herramientas expuestas

Related MCP server: MCP Search & Fetch

🚀 Desplegar en Render (paso a paso)

1. Sube este repositorio a GitHub

cd mcp-web-search
git init
git add .
git commit -m "Initial commit"
# create a repo on github.com, then:
git remote add origin https://github.com/YOUR_USERNAME/mcp-web-search.git
git push -u origin main

2. Crea un nuevo Web Service en Render

1. Ve a render.com → New → Web Service

2. Conecta tu repositorio de GitHub (mcp-web-search)

3. Render detectará automáticamente render.yaml — haz clic en Apply

4. Configura las variables de entorno en el panel de Render:

5. Haz clic en Create Web Service — Render compilará y desplegará automáticamente.

La URL de tu servidor será: https://mcp-web-search.onrender.com (o similar)

🔌 Conectar a AIPI

En el diálogo "Add Custom MCP" de AIPI, pega esta configuración:

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

Reemplaza YOUR-SERVICE con el nombre real de tu servicio de Render (p. ej., mcp-web-search-j73g).

Otros clientes MCP

Funciona con cualquier cliente MCP que admita transporte SSE:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

🔍 Proveedores de búsqueda

Configura SERPER_API_KEY en las variables de entorno de Render para usar Serper. El servidor usa DuckDuckGo automáticamente si la clave no está presente.

🧪 Probar localmente

pip install -r requirements.txt
SERPER_API_KEY=your_key python server.py

Comprobación de estado:

curl http://localhost:3000/

El servidor se ejecuta en el puerto 3000 por defecto. Configura la variable de entorno PORT para cambiarlo.

⚠️ Nota sobre el plan gratuito

El plan gratuito de Render se apaga después de 15 minutos de inactividad (arranque en frío ~30s). Actualiza al plan Starter ($7/mes) para mantenerlo siempre activo.