local-only server

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

Integrations

Provides support for storing Perplexity API keys securely in environment variables for better security practices when sharing code.
Allows Claude to perform web-based research through Perplexity AI's API, providing answers with citations. Supports configuration of parameters like temperature, max tokens, domain filtering, and recency filtering.

Herramienta de perplejidad para Claude Desktop

Una herramienta MCP personalizada que integra la API de Perplexity AI con Claude Desktop, lo que permite a Claude realizar investigaciones basadas en la web y proporcionar respuestas con citas.

Requisitos previos de instalación

Instalar Git:
- Para Mac:
  - Primero instale Homebrew pegando esto en la Terminal: GXP1
  - Luego instala Git: GXP2
- Para Windows:
  - Descargar Git desde git-scm.com
  - Ejecute el instalador
Instalar Node.js:
- Para Mac:
  brew install node
- Para Windows:
  - Descargar desde nodejs.org
  - Ejecute el instalador
Verifique las instalaciones ejecutando:

git --version
node --version

Instalación de herramientas

Clonar el repositorio

git clone https://github.com/letsbuildagent/perplexity-tool
cd perplexity-tool

Instalar dependencias

npm install

Configura tu clave API

Tienes dos opciones:

Opción 1 (Configuración rápida):

Abrir server.js
Encuentra esta línea:

const PERPLEXITY_API_KEY = "YOUR-API-KEY-HERE";

Reemplace con su clave API de Perplexity

Opción 2 (mejor práctica):

Crea un archivo .env:
# On Mac/Linux: touch .env open .env # On Windows: notepad .env
O simplemente crea un nuevo archivo llamado .env en tu editor de texto
Agregue su clave API al archivo .env:
PERPLEXITY_API_KEY=your-api-key-here
Instalar dotenv:
npm install dotenv
Actualizar server.js:
import 'dotenv/config' const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;

Configurar Claude Desktop

Abra ~/Library/Application Support/Claude/claude_desktop_config.json
Añade esta configuración:

{
  "mcpServers": {
    "perplexity-tool": {
      "command": "node",
      "args": [
        "/full/path/to/perplexity-tool/server.js"
      ]
    }
  }
}

Reemplace /full/path/to con la ruta real donde clonó el repositorio.

Reiniciar Claude Desktop

Uso

Una vez instalada, puedes utilizar la herramienta a través de Claude con comandos como:

Pregúntale a Perplexity sobre los últimos avances en IA.
Utilizar la Perplejidad para investigar la historia de la computación cuántica.
"Buscar información sobre el cambio climático en Perplexity, centrándose en el último mes"

Opciones avanzadas

Puede especificar parámetros adicionales:

temperature : controla la aleatoriedad de la respuesta (0-2)
max_tokens : limita la longitud de la respuesta
search_domain_filter : restringe la búsqueda a dominios específicos
search_recency_filter : Filtra por período de tiempo (día/semana/mes/año)

Solución de problemas

Git no encontrado:
- Asegúrate de haber instalado Git correctamente
- Intente reiniciar su terminal
- En Mac, asegúrese de que Homebrew esté en su PATH
Errores de Node.js:
- Verifique la instalación de Node.js con node --version
- Intente reinstalar Node.js
Problemas con la clave API:
- Asegúrate de haber copiado correctamente tu clave API
- Comprueba que no haya espacios adicionales en tu archivo .env
- Si usa la Opción 2, verifique que dotenv esté instalado
Herramienta que no aparece en Claude:
- Verifique la ruta en claude_desktop_config.json
- Asegúrese de que la ruta apunte a su archivo server.js
- Reiniciar Claude Desktop
- Comprueba si hay mensajes de error en la consola.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Nota de seguridad

Si planeas compartir tu código o hacerlo público:

No envíe su clave API a Git
Utilice el método .env (Opción 2)
Añade .env a tu archivo .gitignore

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

ask_perplexity