Perplexity MCP 服务器

这是一个自定义的模型上下文协议 (MCP) 实现，它将 Perplexity AI 作为工具提供者添加到 Claude Desktop 中。

功能

• 通过 MCP 与 Claude Desktop 无缝集成
• 访问 Perplexity 强大的 AI 模型
• 支持单个问题和多轮对话
• 可自定义模型选择

安装

前提条件

• Node.js (v16 或更高版本)
• Claude Desktop (最新版本)
• Perplexity API 密钥

选项 1：克隆并在本地运行

1. 克隆此仓库：
   bash
   git clone https://github.com/Family-IT-Guy/perplexity-mcp.git
   cd perplexity-mcp

2. 安装依赖项：
   bash
   npm install

3. 创建一个包含您的 API 密钥的 .env 文件：

   PERPLEXITY_API_KEY=your_api_key_here

4. 测试服务器：
   bash
   node server.js

选项 2：全局安装

1. 如上所述克隆并导航到仓库

2. 全局安装：
   bash
   npm install -g .

3. 现在您可以从任何地方运行服务器：
   bash
   perplexity-mcp

Claude Desktop 配置

将以下配置添加到您的 claude_desktop_config.json 文件中：

标准配置

json
{
"mcpServers": {
"perplexity": {
"command": "node",
"args": [
"/absolute/path/to/perplexity-mcp/server.js"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}

全局安装配置

json
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": [
"perplexity-mcp"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}

NVM 用户

如果您使用 Node 版本管理器 (NVM)，则需要绝对路径：
json
{
"mcpServers": {
"perplexity": {
"command": "/Users/username/.nvm/versions/node/v16.x.x/bin/node",
"args": [
"/Users/username/path/to/perplexity-mcp/server.js"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}

可用工具

配置完成后，Claude 将可以访问这些工具：

1. perplexity_ask - 向 Perplexity 发送单个问题

   • 参数：
     • query (必需): 要询问的问题
     • model (可选): 模型名称 (默认: llama-3.1-sonar-small-128k-online)

2. perplexity_chat - 进行多轮对话

   • 参数：
     • messages (必需): 对话消息数组
     • model (可选): 模型名称 (默认: mixtral-8x7b-instruct)

故障排除

• 查看日志：cat ~/.claude/logs/perplexity.log
• 确保您的 API 密钥有效
• 验证您的 claude_desktop_config.json 格式
• 通过在 env 部分添加 "DEBUG": "1" 来启用详细日志记录

工作原理

该实现使用 Anthropic 创建的模型上下文协议 (MCP) 来扩展 Claude Desktop 的功能。它：

1. 创建一个通过 stdio 与 Claude 通信的 MCP 服务器
2. 在 Claude 中注册 Perplexity 工具
3. 将来自 Claude 的请求代理到 Perplexity API
4. 将响应返回给 Claude 以显示

许可证

该项目根据 ISC 许可证许可 - 有关详细信息，请参阅 LICENSE 文件。