Servidor MCP de Perplexity

Un servidor MCP que proporciona capacidades de búsqueda web utilizando la API de Perplexity con selección automática de modelos según la intención de la consulta.

Prerrequisitos

• Node.js (v14 o superior)

• Una clave API de Perplexity (obtenga una en https://www.perplexity.ai/settings/api )

• Aplicación de escritorio Claude

Related MCP server: Perplexity MCP Server

Instalación

Instalación mediante Git

1. Clonar este repositorio:

   git clone https://github.com/RossH121/perplexity-mcp.git
   cd perplexity-mcp

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

Configuración

1. Obtén tu clave API de Perplexity en https://www.perplexity.ai/settings/api

2. Agregue el servidor al archivo de configuración de Claude en ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "perplexity-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/build/index.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here",
        "PERPLEXITY_MODEL": "sonar"
      }
    }
  }
}

Reemplace /absolute/path/to con la ruta real a donde clonó el repositorio.

Modelos disponibles

El servidor ahora admite la selección automática de modelos según la intención de la consulta, pero también puede especificar un modelo predeterminado mediante la variable de entorno PERPLEXITY_MODEL . Opciones disponibles:

• sonar-deep-research : especializado para investigación exhaustiva y análisis a nivel experto en todos los dominios

• sonar-reasoning-pro - Optimizado para razonamiento lógico avanzado y resolución de problemas complejos

• sonar-reasoning - Diseñado para tareas de razonamiento con un rendimiento equilibrado

• sonar-pro - Modelo de propósito general con excelentes capacidades de búsqueda y densidad de citas

• sonar : rápido y eficiente para consultas sencillas

El modelo predeterminado (especificado en la variable de entorno) se utilizará como base para la selección automática del modelo.

Para conocer los precios y la disponibilidad de los modelos actualizados, visite: https://docs.perplexity.ai/guides/pricing

Uso

Después de configurar el servidor y reiniciar Claude, puedes simplemente pedirle que busque información. Por ejemplo:

• "¿Cuáles son las últimas noticias sobre SpaceX?"

• Busca los mejores restaurantes de Chicago.

• Encuentra información sobre la historia del jazz.

• Necesito un análisis profundo de los últimos avances en IA (utiliza sonar-deep-research)

• "Ayúdame a resolver este problema complejo" (usa sonar-reasoning-pro)

Claude usará automáticamente la herramienta de búsqueda Perplexity para encontrar y devolver información relevante. El servidor seleccionará automáticamente el modelo más adecuado según la intención de su consulta.

Si por alguna razón decide no utilizar la herramienta de búsqueda, puede forzar el problema anteponiendo a su mensaje "Buscar en la web".

Selección inteligente de modelos

El servidor selecciona automáticamente el modelo de Perplejidad más apropiado en función de su consulta:

• Utilice términos orientados a la investigación como "investigación profunda", "exhaustivo" o "en profundidad" para activar la investigación profunda del sonar.

• Utilice términos de razonamiento como "resolver", "averiguar" o "problema complejo" para activar el proceso de razonamiento del sonar.

• Utilice términos simples como "rápido", "breve" o "básico" para activar el modelo de sonar liviano.

• Los términos de búsqueda generales tienen como opción predeterminada sonar-pro para un rendimiento equilibrado

Cada respuesta de búsqueda incluye información sobre qué modelo se utilizó y por qué.

Filtrado de dominios

Este servidor admite el filtrado de dominios para personalizar tu experiencia de búsqueda. Puedes permitir o bloquear dominios específicos con estos comandos:

• Añadir un dominio permitido : "Utilice la herramienta domain_filter para permitir wikipedia.org"

• Agregar un dominio bloqueado : "Usa la herramienta domain_filter para bloquear pinterest.com"

• Ver filtros actuales : "Usar la herramienta list_filters" (muestra filtros de dominio y actualidad)

• Borrar todos los filtros : "Usar la herramienta clear_filters" (borra los filtros de dominio y de actualidad)

Nota : La API de Perplexity admite hasta 3 dominios en total, priorizando los permitidos. El filtrado de dominios requiere un nivel de la API de Perplexity compatible con esta función.

Ejemplo de flujo de uso:

1. Utilice la herramienta domain_filter para permitir wikipedia.org.

2. Utilice la herramienta domain_filter para permitir arxiv.org.

3. "Utilice la herramienta list_filters" (para verificar su configuración)

4. Búsqueda de avances en computación cuántica (los resultados priorizarán wikipedia.org y arxiv.org)

Filtrado de actualidad

Puede limitar los resultados de búsqueda a un período de tiempo específico utilizando el filtro de actualidad:

• Establecer filtro de actualidad : "Usar la herramienta recency_filter con filtro=hora" (opciones: hora, día, semana, mes)

• Deshabilitar el filtro de actualidad : "Usar la herramienta recency_filter con filter=none"

Esto es particularmente útil para consultas sensibles al tiempo, como eventos actuales o noticias de último momento.

Control de selección de modelos

Si bien la selección automática de modelo funciona bien en la mayoría de los casos, puedes controlar manualmente qué modelo se utiliza:

• Ver información del modelo : "Usar la herramienta model_info"

• Establecer un modelo específico : "Usar la herramienta model_info con model=sonar-deep-research"

• Volver a la selección automática : Restablecer el modelo al modelo predeterminado

Ejemplo de uso:

1. "Utilice la herramienta model_info" (para ver los modelos disponibles y su estado actual)

2. "Utilice la herramienta model_info con model=sonar-reasoning-pro" (para forzar el uso del modelo de razonamiento)

3. "Búsqueda de una demostración matemática del teorema de Pitágoras" (se utilizará sonar-reasoning-pro)

4. "Utilice la herramienta model_info con model=sonar-pro" (para volver a la selección automática)

Desarrollo

Para modificar el servidor:

1. Editar src/index.ts

2. Reconstruir con npm run build

3. Reinicie Claude para cargar los cambios

Licencia

Instituto Tecnológico de Massachusetts (MIT)