Servidor MCP de Perplexity Chat

El servidor MCP de Perplexity proporciona una interfaz basada en Python para la API de Perplexity, con herramientas para consultar respuestas, mantener el historial de chat y gestionar conversaciones. Admite la configuración de modelos mediante variables de entorno y almacena los datos de chat localmente. Desarrollado con Python y setuptools, está diseñado para la integración con entornos de desarrollo.

El servidor MCP está diseñado para imitar cómo los usuarios interactúan con Perplexity Chat en su navegador al permitir que sus modelos hagan preguntas, continúen conversaciones y enumeren todos sus chats.

Componentes

Herramientas

ask_perplexity : Solicita asistencia experta en programación a través de Perplexity. Se centra en soluciones de codificación, depuración de errores y explicaciones técnicas. Devuelve respuestas con citas de fuentes y sugerencias alternativas.
chat_perplexity : Mantiene conversaciones en curso con la IA de Perplexity. Crea nuevos chats o continúa los existentes con el historial completo. Devuelve el ID del chat para futuras continuaciones.
list_chats_perplexity : Enumera todas las conversaciones de chat disponibles con Perplexity AI. Devuelve los ID, títulos y fechas de creación de los chats (en formato de tiempo relativo, p. ej., "hace 5 minutos", "hace 2 días"). Los resultados se paginan con 50 chats por página.
read_chat_perplexity : Recupera el historial completo de conversaciones de un chat específico. Devuelve el historial completo del chat con todos los mensajes y sus marcas de tiempo. No se realizan llamadas a la API de Perplexity; solo lee del almacenamiento local.

Características principales

Configuración del modelo a través de la variable de entorno: le permite especificar el modelo de Perplexity utilizando la variable de entorno PERPLEXITY_MODEL para una selección de modelo flexible.También puede especificar PERPLEXITY_MODEL_ASK y PERPLEXITY_MODEL_CHAT para utilizar modelos diferentes para las herramientas ask_perplexity y chat_perplexity , respectivamente.Estos reemplazarán PERPLEXITY_MODEL . Puede consultar los modelos disponibles en la documentación de Perplexity .
Historial de chat persistente: La herramienta chat_perplexity mantiene conversaciones en curso con Perplexity AI. Crea nuevos chats o continúa los existentes con el historial completo. Devuelve el ID del chat para futuras continuaciones.
Respuestas de transmisión con informes de progreso: utiliza informes de progreso para evitar tiempos de espera en respuestas lentas.

Inicio rápido

Prerrequisitos

Antes de utilizar este servidor MCP, asegúrese de tener:

Python 3.10 o superior
Administrador de paquetes uvx instalado

Nota: Las instrucciones de instalación de uvx están disponibles aquí .

Configuración para todos los clientes

Para utilizar este servidor MCP, configure su cliente con estos ajustes (el método de configuración varía según el cliente):

"mcpServers": {
  "mcp-perplexity": {
    "command": "uvx",
    "args": ["mcp-perplexity"],
    "env": {
      "PERPLEXITY_API_KEY": "your-api-key",
      "PERPLEXITY_MODEL": "sonar-pro",
      "DB_PATH": "chats.db"
    }
  }
}

Variables de entorno

Configure el servidor MCP Perplexity utilizando las siguientes variables de entorno:

Variable	Descripción	Valor predeterminado	Requerido
`PERPLEXITY_API_KEY`	Su clave API de Perplexity	Ninguno	Sí
`PERPLEXITY_MODEL`	Modelo predeterminado para interacciones	`sonar-pro`	No
`PERPLEXITY_MODEL_ASK`	Modelo específico para la herramienta `ask_perplexity`	Utiliza `PERPLEXITY_MODEL`	No
`PERPLEXITY_MODEL_CHAT`	Modelo específico para la herramienta `chat_perplexity`	Utiliza `PERPLEXITY_MODEL`	No
`DB_PATH`	Ruta para almacenar la base de datos del historial de chat	`chats.db`	No
`WEB_UI_ENABLED`	Habilitar o deshabilitar la interfaz web	`false`	No
`WEB_UI_PORT`	Puerto para interfaz web	`8050`	No
`WEB_UI_HOST`	Host para interfaz de usuario web	`127.0.0.1`	No
`DEBUG_LOGS`	Habilitar el registro detallado	`false`	No

Uso de Smithery CLI

npx -y @smithery/cli@latest run @daniel-lxs/mcp-perplexity --config "{\"perplexityApiKey\":\"pplx-abc\",\"perplexityModel\":\"sonar-pro\"}"

Uso

pregunta_perplejidad

La herramienta ask_perplexity se utiliza para preguntas específicas, esta herramienta no mantiene un historial de chat, cada solicitud es un nuevo chat.

La herramienta devolverá una respuesta de Perplexity AI utilizando el modelo PERPLEXITY_MODEL_ASK si se especifica; de lo contrario, utilizará el modelo PERPLEXITY_MODEL .

perplejidad del chat

La herramienta chat_perplexity se utiliza para conversaciones en curso y mantiene un historial de chat. Cada chat se identifica mediante un ID de chat, que la herramienta devuelve al crear un nuevo chat. Los ID de chat tienen el siguiente aspecto: wild-horse-12 .

Esta herramienta es útil para depurar, investigar y cualquier otra tarea que requiera un historial de chat.

La herramienta devolverá una respuesta de Perplexity AI utilizando el modelo PERPLEXITY_MODEL_CHAT si se especifica; de lo contrario, utilizará el modelo PERPLEXITY_MODEL .

lista_chats_perplejidad

Enumera todas las conversaciones de chat disponibles. Devuelve una lista paginada de chats, que muestra el ID, el título y la hora de creación (en formato relativo). Puedes especificar el número de página con el argumento page (el valor predeterminado es 1, con 50 chats por página).

perplejidad al leer el chat

Recupera el historial completo de conversaciones para un chat_id determinado. Esta herramienta devuelve todos los mensajes del chat, incluyendo las marcas de tiempo y los roles (usuario o asistente). Esta herramienta no realiza llamadas a la API de Perplexity; solo lee de la base de datos local.

Interfaz web

El servidor MCP Perplexity ahora incluye una interfaz web para facilitar la interacción y la gestión de los chats.

Características

Interfaz de chat interactiva
Gestión del historial de chat
Visualización de mensajes en tiempo real

Capturas de pantalla

Vista de lista de chat

Interfaz de chat

Acceder a la interfaz web

Cuando WEB_UI_ENABLED se establece en true , la interfaz de usuario web estará disponible en http://WEB_UI_HOST:WEB_UI_PORT .

De forma predeterminada, es http://127.0.0.1:8050 .

Desarrollo

Este proyecto utiliza herramientas de configuración para el desarrollo y la compilación. Para empezar:

Crear un entorno virtual:
python -m venv .venv source .venv/bin/activate # On Linux/macOS # or .venv\Scripts\activate # On Windows
Instalar el proyecto en modo editable con todas las dependencias:
pip install -e .
Construir el proyecto:
python -m build

El entorno virtual contendrá todas las dependencias necesarias para el desarrollo.

Contribuyendo

Este proyecto está abierto a contribuciones. Para más información, consulte el archivo CONTRIBUTING.md .

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Perplexity MCP Server

Integrations