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.

security – no known vulnerabilities

license - not found

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

MCP Perplexity Search
spences10
A
security
A
license
A
quality
Enables integration of Perplexity's AI API with LLMs, delivering advanced chat completion by utilizing specialized prompt templates for tasks like technical documentation, code review, and API documentation.
Last updated -
1
94
8
JavaScript
MIT License
Perplexity AI MCP Server
fr0ziii
A
security
F
license
A
quality
This server provides access to the Perplexity AI API, enabling interaction through chatting, searching, and documentation retrieval within MCP-based systems.
Last updated -
5
2
JavaScript
Perplexity MCP Server
sengokudaikon
-
security
A
license
-
quality
Provides access to Perplexity AI models through two tools: ask\_perplexity for expert programming assistance and chat\_perplexity for maintaining ongoing conversations with context preservation.
Last updated -
Python
MIT License
MCP Gemini Server
amitsh06
-
security
F
license
-
quality
A server implementing the Model Context Protocol that enables AI assistants like Claude to interact with Google's Gemini API for text generation, text analysis, and chat conversations.
Last updated -
Python

View all related MCP servers

Perplexity MCP Server