Servidor MCP de búsqueda web de Perplexity

Un servidor MCP (Protocolo de Contexto de Modelo) simple que proporciona funciones de búsqueda web mediante la API de Perplexity. Este servidor permite a Claude y a otros asistentes de IA compatibles con MCP buscar en la web y obtener información actualizada.

Características

• Busque en la web con las potentes capacidades de búsqueda de Perplexity
• Obtenga resultados de búsqueda completos con fuentes y citas
• Filtrar resultados por período de tiempo (día, semana, mes, año)
• Incluye una plantilla de solicitud lista para usar para búsquedas web
• Admite la carga de claves API desde variables de entorno o archivos .env

Instalación

1. Clonar este repositorio
2. Instalar dependencias:
   pip install -e .
   o
   uv pip install -e .

Configuración

Puede configurar la variable de entorno PERPLEXITY_API_KEY con su clave API de Perplexity:

Alternativamente, puede crear un archivo .env en la raíz del proyecto con el siguiente contenido:

Se proporciona un archivo .env.example de muestra como referencia.

Para obtener una clave API de Perplexity:

1. Visita la configuración de la API de Perplexity
2. Crea una cuenta si no tienes una
3. Generar una clave API

Uso

Ejecutando el servidor

Probando el servidor

Puede probar la funcionalidad del servidor sin ejecutar el servidor MCP completo utilizando el script de prueba incluido:

Las opciones para --recency son: día, semana, mes (predeterminado), año

Uso con Claude Desktop

1. Edite su archivo de configuración de Claude Desktop:
   • En macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%/Claude/claude_desktop_config.json
2. Agregue la siguiente configuración:
   { "perplexity-mcp": { "env": { "PERPLEXITY_API_KEY": "your-api-key-here" }, "command": "python", "args": [ "/path/to/server.py" ] } }
3. Reiniciar Claude Desktop

Ejemplos de indicaciones para Claude

• Busca en la web las últimas noticias sobre inteligencia artificial.
• Utilice Perplexity para encontrar información sobre el cambio climático publicada la semana pasada.
• Busque artículos de investigación recientes sobre computación cuántica del último mes.

Referencia de API

Herramienta: search_web(query: str, recency: str = "month") -> str

Busque en la web utilizando la API de Perplexity y obtenga resultados.

Parámetros:

• query : La cadena de consulta de búsqueda
• recency : Filtrar resultados por período de tiempo: 'día', 'semana', 'mes' (predeterminado) o 'año'

Devuelve: Una respuesta de texto completa que contiene:

1. Un resumen detallado de los resultados de la búsqueda
2. Datos e información clave encontrados
3. Fuentes con URL para verificación
4. Cualquier información contradictoria si está presente

Indicación: web_search_prompt(query: str, recency: str = "month") -> str

Crea una plantilla de solicitud para buscar en la web con Perplexity.

Parámetros:

• query : La consulta de búsqueda
• recency : filtro de período de tiempo: 'día', 'semana', 'mes' (predeterminado) o 'año'

Devuelve: una cadena de mensaje formateada que indica a la IA que:

1. Buscar la consulta especificada
2. Centrarse en los resultados del período de tiempo especificado
3. Resumir los hallazgos clave
4. Resaltar hechos importantes
5. Mencionar información contradictoria
6. Citar fuentes con enlaces

Licencia

Instituto Tecnológico de Massachusetts (MIT)