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

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:

perplexity_ask - Envía una pregunta directa a Perplexity AI
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

Construir el servidor:
npm run build
Abra Windsurf y navegue hasta Configuración
Busque la sección "Configuración de IA" o "Protocolo de contexto del modelo".
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
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:

Verifique que su clave API sea válida y esté configurada correctamente en el archivo .env
Verifique que el formato de respuesta coincida con la especificación MCP
Busque mensajes de error en los registros del servidor
Asegúrese de que Windsurf esté configurado correctamente para usar el servidor MCP

Licencia

Instituto Tecnológico de Massachusetts (MIT)