Servidor MCP de Perplexity

Descripción general

El servidor MCP de Perplexity es una implementación en Node.js del Protocolo de Contexto de Modelo (MCP) de Anthropic que permite a Claude interactuar con los modelos de lenguaje de Perplexity. Este servidor proporciona un puente seguro entre Claude y las capacidades de Perplexity AI, lo que permite interacciones mejoradas con la IA mediante el uso de herramientas.

Herramientas disponibles

El servidor actualmente implementa dos herramientas principales:

1. perplejidad_chat

Herramienta avanzada para completar chats con soporte para historial completo de mensajes.

2. perplejidad_pregunta

Interfaz de consulta única simplificada para preguntas rápidas.

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

   npm install

3. Crear archivo .env :

   PERPLEXITY_API_KEY=your-api-key-here

4. Construir el proyecto:

   npm run build

Configuración del escritorio de Claude

Para agregar este servidor a Claude Desktop, actualice su claude_desktop_config.json :

El archivo de configuración normalmente se encuentra en:

• Ventanas: %APPDATA%/Claude/config/claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json

• Linux: ~/.config/Claude/config/claude_desktop_config.json

Desarrollo

Inicie el servidor de desarrollo con recompilación automática:

El servidor utiliza TypeScript e implementa el protocolo MCP utilizando el paquete @modelcontextprotocol/sdk .

Arquitectura

Componentes principales

1. Clase PerplexityServer

   • Implementa el protocolo de servidor MCP

   • Maneja el registro y ejecución de herramientas.

   • Gestiona el manejo de errores y el ciclo de vida del servidor.

2. Sistema de herramientas

   • Definiciones de herramientas modulares

   • Manipuladores de herramientas con seguridad de tipos

   • Validación de entrada estructurada

Detalles técnicos

• Creado con TypeScript para seguridad de tipos

• Utiliza @modelcontextprotocol/sdk para la implementación de MCP

• Se comunica a través del transporte stdio

• Configuración basada en el entorno

Manejo de errores

El servidor implementa un manejo integral de errores:

• Informe de errores de API

• Manejo de solicitudes de herramientas no válidas

• Gestión de errores de conexión

• Manejo de señales de proceso

Dependencias

• @modelcontextprotocol/sdk : ^1.0.3

• dotenv : ^16.4.7

• isomorphic-fetch : ^3.0.0

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Seguridad

• Las claves API se gestionan a través de variables de entorno

• Validación de entrada para todos los parámetros de la herramienta

• Los mensajes de error se desinfectan antes de su salida.

• Aislamiento de procesos mediante el protocolo MCP

Licencia

Este proyecto está licenciado bajo la licencia ISC.

Solución de problemas

Problemas comunes y soluciones:

1. Servidor no encontrado

   • Verifique que la ruta en claude_desktop_config.json sea correcta

   • Asegúrese de que el servidor esté compilado ( npm run build )

   • Comprueba si Node.js está en tu PATH

2. Errores de autenticación

   • Verifique su clave API de Perplexity en .env

   • Compruebe si la clave API tiene los permisos necesarios

3. Errores de ejecución de herramientas

   • Verifique que los parámetros de la herramienta coincidan con el esquema

   • Comprobar la conectividad de la red

   • Revise los registros del servidor para ver mensajes de error detallados