local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Perplexity AI's language models, providing capabilities to generate chat completions with full message history support and send simple queries for quick answers using various Llama-based models.

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.

{
  "name": "perplexity_chat",
  "description": "Generate a chat completion using Perplexity AI",
  "parameters": {
    "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online",
    "messages": "array of {role, content} objects - The conversation history",
    "temperature": "number (optional) - Sampling temperature between 0-2"
  }
}

2. perplejidad_pregunta

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

{
  "name": "perplexity_ask",
  "description": "Send a simple query to Perplexity AI",
  "parameters": {
    "query": "string - The question or prompt to send",
    "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

Instalación

Clonar el repositorio:
git clone https://github.com/yourusername/perplexity-mcp-server.git cd perplexity-mcp-server
Instalar dependencias:
npm install
Crear archivo .env :
PERPLEXITY_API_KEY=your-api-key-here
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 :

{
  "mcpServers": {
    //more servers...
    "perplexity": {
      "command": "node",
      "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY"
      }
    }
    //more servers...
  }
}

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:

npm run dev

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

Arquitectura

Componentes principales

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.
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

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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:

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
Errores de autenticación
- Verifique su clave API de Perplexity en .env
- Compruebe si la clave API tiene los permisos necesarios
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

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Una implementación de Node.js que permite a Claude interactuar con los modelos de lenguaje de Perplexity AI a través del Protocolo de Contexto de Modelo de Anthropic, proporcionando herramientas para completar chats avanzados y realizar consultas rápidas.

Related Resources

Reddit Discussion about this server

Perplexity MCP Server