Servidor MCP de SerpApi

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que se integra con SerpApi para obtener resultados completos de motores de búsqueda y extracción de datos.

Características

• Búsqueda multi-motor: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay y más

• Recursos del motor: Esquemas de parámetros por motor disponibles a través de recursos MCP (ver Herramienta de Búsqueda)

• Datos meteorológicos en tiempo real: Clima basado en la ubicación con pronósticos mediante consultas de búsqueda

• Datos del mercado de valores: Finanzas de empresas y datos de mercado a través de la integración de búsqueda

• Procesamiento dinámico de resultados: Detecta y formatea automáticamente diferentes tipos de resultados

• Modos de respuesta flexibles: Respuestas JSON completas o compactas

• Respuestas JSON: Salida JSON estructurada con modos completo o compacto

Related MCP server: SearXNG MCP Server

Inicio rápido

El servidor MCP de SerpApi está disponible como un servicio alojado en mcp.serpapi.com. Para conectarse a él, debe proporcionar una clave API. Puede encontrar su clave API en su panel de control de SerpApi.

Puede configurar Claude Desktop para usar el servidor alojado:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Auto-alojamiento

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Configure Claude Desktop:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Obtenga su clave API: serpapi.com/manage-api-key

Autenticación

Se admiten dos métodos:

• Basado en ruta: /YOUR_API_KEY/mcp (recomendado)

• Basado en encabezado: Authorization: Bearer YOUR_API_KEY

Ejemplos:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

Herramienta de Búsqueda

El servidor MCP tiene una Herramienta de Búsqueda principal que admite todos los motores y tipos de resultados de SerpApi. Puede encontrar todos los parámetros disponibles en la referencia de la API de SerpApi. Los esquemas de parámetros del motor también se exponen como recursos MCP: serpapi://engines (índice) y serpapi://engines/<engine>.

Los parámetros que puede proporcionar son específicos para cada motor de API. A continuación se muestran algunos parámetros de muestra:

• params.q (obligatorio): Consulta de búsqueda

• params.engine: Motor de búsqueda (predeterminado: "google_light")

• params.location: Filtro geográfico

• mode: Modo de respuesta - "complete" (predeterminado) o "compact"

• ...vea otros parámetros en la referencia de la API de SerpApi

Ejemplos:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

Motores admitidos: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay y más (ver serpapi://engines).

Tipos de resultados: Cuadros de respuesta, resultados orgánicos, noticias, imágenes, compras: detectados y formateados automáticamente.

Desarrollo

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Solución de problemas

• "Missing API key": Incluya la clave en la ruta de la URL /{YOUR_KEY}/mcp o en el encabezado Bearer YOUR_KEY

• "Invalid key": Verifique en serpapi.com/dashboard

• "Rate limit exceeded": Espere o actualice su plan de SerpApi

• "No results": Intente con una consulta o motor diferente

Contribución

1. Haga un fork del repositorio

2. Cree su rama de características: git checkout -b feature/amazing-feature

3. Instale las dependencias: uv install

4. Realice sus cambios

5. Confirme los cambios: git commit -m 'Add amazing feature'

6. Envíe a la rama: git push origin feature/amazing-feature

7. Abra una Solicitud de Extracción (Pull Request)

Licencia

Licencia MIT - consulte el archivo LICENSE para obtener más detalles.