Perplexity Search

Accede a la API de búsqueda de Perplexity para obtener información y respuestas en tiempo real.

Documentación

Servidor MCP de Perplexity Search

License: MIT

Una implementación en Go de un servidor MCP de Perplexity Search que permite a los modelos de lenguaje grandes (LLMs) acceder a la API de búsqueda de Perplexity a través del Protocolo de Contexto de Modelo (MCP).

Características

  • perplexity_search: Realiza búsquedas web y devuelve resultados, incluyendo citas
    • Parámetros:
      • query (cadena, obligatorio): La consulta de búsqueda
      • search_recency_filter (cadena, opcional): Filtra resultados por tiempo (month, week, day, hour)
      • max_tokens (entero, opcional): Número máximo de tokens a devolver
      • temperature (número, opcional, predeterminado: 0.2): Controla la aleatoriedad en la respuesta
      • top_p (número, opcional, predeterminado: 0.9): Umbral de muestreo de núcleo
      • search_domain_filter (matriz, opcional): Lista de dominios para limitar los resultados de búsqueda
      • return_images (booleano, opcional): Incluir enlaces de imágenes en los resultados
      • return_related_questions (booleano, opcional): Incluir preguntas relacionadas
      • top_k (número, opcional, predeterminado: 0): Número de tokens para el filtrado top-k
      • stream (booleano, opcional): Transmitir la respuesta de forma incremental
      • presence_penalty (número, opcional, predeterminado: 0): Ajusta la probabilidad de nuevos temas
      • frequency_penalty (número, opcional, predeterminado: 1): Reduce la repetición
      • web_search_options (objeto, opcional): Opciones de configuración para la búsqueda web

Configuración y Uso

Instalación mediante Smithery

Para instalar Perplexity Search Golang para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @chenxilol/perplexity-mcp-go --client claude

Requisitos previos

  • Go 1.23 o superior
  • Clave de API de Perplexity

Instalación

  1. Clona el repositorio:
git clone https://github.com/chenxilol/perplexity-mcp-go.git
cd perplexity-mcp-go
  1. Compila la aplicación:
go build -o perplexity-search-mcp

Ejecución Local

  1. Establece tu clave de API de Perplexity:
export PERPLEXITY_API_KEY="your-api-key-here"
  1. Ejecuta el servidor:
./perplexity-search-mcp

Integración con Claude

  1. Copia el claude_desktop_config.json proporcionado a tu directorio de configuración de Claude:

    • Windows: %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Edita el archivo de configuración para incluir tu clave de API:

{
  "mcpServers": {
    "perplexity-search": {
      "command": "/path/to/perplexity-search-mcp",
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Soporte Docker

  1. Compila la imagen Docker:
docker build -t perplexity-search-mcp:latest .
  1. Ejecuta el contenedor:
docker run -i --rm -e PERPLEXITY_API_KEY=your-api-key-here perplexity-search-mcp:latest

Ejemplo de Uso

Una vez configurado, Claude puede usar la herramienta perplexity_search a través de MCP para realizar búsquedas web en tiempo real.

Ejemplo de búsqueda con parámetros:

{
  "query": "latest AI research developments",
  "search_recency_filter": "week",
  "temperature": 0.5,
  "return_related_questions": true,
  "web_search_options": {
    "search_context_size": "high"
  }
}

Solución de Problemas

Si encuentras problemas:

  1. Verifica que tu clave de API esté configurada correctamente
  2. Comprueba la conectividad de red
  3. Examina los registros de stderr para ver mensajes de error

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENCIA para más detalles.

Agradecimientos