Servidor MCP de Perplexity Insight

Una implementación de servidor MCP para interactuar con la API de Perplexity AI, brindando capacidades avanzadas de respuesta a preguntas a través del Protocolo de contexto de modelo estandarizado.

Características

• Integración perfecta con la API de Perplexity AI

• Soporte para diferentes modelos de Perplejidad (sonar-reasoning, sonar-pro, sonar-deep-research)

• Avisos del sistema y consultas de usuario personalizables

• Manejo adecuado de errores y formato de respuesta

• Protección de limitación de velocidad

• Fácil integración con Windsurf IDE

Related MCP server: Perplexity MCP Server

Requisitos

• Node.js 18+

• Clave API de Perplexity

Instalación

npm install

Variables de entorno

Crea un archivo .env con las siguientes variables:

PERPLEXITY_API_KEY=your_api_key_here

Uso

Ejecutar el servidor:

npm start

Herramientas API

El servidor expone las siguientes herramientas:

1. perplexity_ask - Envía una pregunta directa a Perplexity AI

2. perplexity_search - Realizar una consulta de búsqueda con Perplexity AI

Cambio de modelos

Ambas herramientas admiten los siguientes modelos de perplejidad:

• sonar-reasoning (predeterminado): modelo de Perplexity centrado en el razonamiento, ideal para preguntas generales.

• sonar-pro : modelo mejorado con capacidades mejoradas para casos de uso profesional

• sonar-deep-research - Especializado para investigaciones en profundidad y consultas complejas

Para especificar un modelo al utilizar las herramientas, incluya el parámetro model en su solicitud:

Ask Perplexity using sonar-deep-research: What are the latest advancements in quantum computing?

También puedes personalizar el mensaje del sistema y el recuento máximo de tokens:

Search with Perplexity using sonar-pro with system prompt "You are a helpful research assistant" and max tokens 2000: Latest developments in renewable energy

Formato de respuesta de la herramienta

El servidor sigue la especificación MCP para las respuestas de las herramientas:

{
  content: [
    {
      type: "text",
      text: "Response content from Perplexity AI"
    }
  ],
  isError: false // or true if an error occurred
}

Integración de windsurf

Configuración en Windsurf

1. Construir el servidor:

   npm run build

2. Abra Windsurf y navegue hasta Configuración

3. Busque la sección "Configuración de IA" o "Protocolo de contexto del modelo".

4. Agregue un nuevo servidor MCP con los siguientes detalles:

   • Nombre : Perplejidad Insight

   • Tipo : Proceso local

   • Comando : Ruta a su ejecutable Node.js

   • Argumentos : Ruta a su archivo index.js compilado

   • Directorio de trabajo : ruta al directorio de su proyecto

   • Variables de entorno : asegúrese de incluir PERPLEXITY_API_KEY=your_api_key_here

5. Habilite el servidor y reinicie Windsurf si es necesario

Ejemplo de configuración

A continuación se muestra un ejemplo de configuración para el archivo mcp_config.json :

"perplexity-ask": {
  "command": "node",
  "args": [
    "/path/to/perplexity-insight-MCP/dist/index.js"
  ],
  "cwd": "/path/to/perplexity-insight-MCP",
  "env": {
    "PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Reemplace /path/to/perplexity-insight-MCP con la ruta real a su directorio de instalación y use su clave API de Perplexity real.

Usando la perplejidad en el windsurf

• Utilice el panel del Asistente de IA para hacer preguntas que se dirigirán a Perplexity

• Para búsquedas web, incluya términos específicos como "buscar" en sus consultas.

• Para cambiar de modelo, incluya el nombre del modelo en su consulta como se muestra en la sección "Cambio de modelo".

• Windsurf utilizará automáticamente la herramienta de Perplejidad adecuada en función de su consulta.

Desarrollo

Para el desarrollo local:

npm run dev

Solución de problemas

Si encuentra problemas con el servidor MCP:

1. Verifique que su clave API sea válida y esté configurada correctamente en el archivo .env

2. Verifique que el formato de respuesta coincida con la especificación MCP

3. Busque mensajes de error en los registros del servidor

4. Asegúrese de que Windsurf esté configurado correctamente para usar el servidor MCP

Licencia

Instituto Tecnológico de Massachusetts (MIT)