perplexity MCP 服务器

概述

perplexity MCP 服务器是一个基于 Node.js 实现的 Anthropic 的模型上下文协议 (MCP) 的服务器，它使 Claude 能够与 Perplexity 的语言模型交互。该服务器在 Claude 和 Perplexity AI 的能力之间提供了一个安全的桥梁，通过工具使用增强了人工智能互动。

可用工具

当前服务器实现了两个主要工具：

1. perplexity_chat

带完整消息历史支持的高级聊天完成工具。

{
  "name": "perplexity_chat",
  "description": "使用 Perplexity AI 生成聊天完成",
  "parameters": {
    "model": "字符串（可选）- 其中之一：llama-3.1-sonar-small-128k-online，llama-3.1-sonar-large-128k-online，llama-3.1-sonar-huge-128k-online",
    "messages": "数组的 {role, content} 对象 - 对话历史记录",
    "temperature": "数字（可选）- 采样温度在 0-2 之间"
  }
}

2. perplexity_ask

简化的单查询接口，用于快速问题。

{
  "name": "perplexity_ask",
  "description": "向 Perplexity AI 发送简单查询",
  "parameters": {
    "query": "字符串 - 要发送的问题或提示",
    "model": "字符串（可选）- 其中之一：llama-3.1-sonar-small-128k-online，llama-3.1-sonar-large-128k-online，llama-3.1-sonar-huge-128k-online"
  }
}

安装

1. 克隆仓库：

   git clone https://github.com/yourusername/perplexity-mcp-server.git
   cd perplexity-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 创建 .env 文件：

   PERPLEXITY_API_KEY=你的API密钥在此处
   

4. 构建项目：

   npm run build
   

Claude Desktop 配置

要将此服务器添加到 Claude Desktop，请更新您的 claude_desktop_config.json：

{
  "mcpServers": {
    // 更多服务器...
    "perplexity": {
      "command": "node",
      "args": ["路径\\to\\perplexity-mcp-server\\dist\\main.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

将 yourusername 替换为您的实际仓库拥有者，并确保 Node.js 在 PATH 中。

架构

核心组件

• MCP 协议适配器：实现与 Claude 的通信。
• 工具执行：处理 perplexity_chat 和 perplexity_ask 工具的调用。
• API Key 管理：安全地使用 Perplexity API 密钥。

实现细节

• 使用 Node.js 模块系统组织代码。
• 采用 async/await 处理异步操作。
• 配置管理通过 .env 文件实现。

故障排除

1. 服务器启动问题

   • 确保 Node.js 已正确安装
   • 检查 package.json 和依赖项是否完整

2. API 访问错误

   • 确认 API 密钥正确且有效
   • 检查网络连接和防火墙设置

3. 工具执行失败

   • 验证输入参数符合要求
   • 查看控制台输出的详细错误信息

代码示例

const express = require('express');
const { Configuration, OpenAIApi } = require('openai');

const app = express();

app.use(express.json());

const configuration = new Configuration({
  apiKey: process.env.PERPLEXITY_API_KEY,
});

const perplexity = new OpenAIApi(configuration);

app.post('/chat', async (req, res) => {
  try {
    const { model, messages, temperature } = req.body;
    
    const completion = await perplexity.chat.completions.create({
      model: model || 'llama-3.1-sonar-small-128k-online',
      messages: messages,
      temperature: temperature || 0.7,
    });

    res.json({ 
      content: completion.choices[0].message.content,
      status: "success"
    });
    
  } catch (error) {
    console.error('Error:', error);
    res.status(500).json({ 
      content: error.message,
      status: "error"
    });
  }
});

app.listen(3000, () => {
  console.log('服务器在 http://localhost:3000 上运行');
});

许可证

项目在 MIT 许可证下发布，详细信息请参阅 LICENSE 文件。

贡献者

• 张三 - 初始实现
• 李四 - 代码优化

链接

• Perplexity 官网
• OpenAI 官方文档