perplexity-insight-MCP服务端

项目概述

一个用于与Perplexity AI接口交互的MCP服务器实现，提供通过标准化模型上下文协议（Model Context Protocol）进行高级问题解答的能力。

功能

• 与Perplexity AI API无缝集成
• 支持不同的Perplexity模型（sonar-reasoning, sonar-pro, sonar-deep-research）
• 可定制的系统提示和用户查询
• 正确的错误处理和响应格式化
• 防止速率限制的保护
• 与Windsurf IDE轻松集成

安装要求

• Node.js 18+
• Perplexity API密钥

安装

npm install

环境变量

创建一个.env文件，包含以下变量：

PERPLEXITY_API_KEY=your_api_key_here

使用方法

运行服务器：

npm start

API工具

服务器公开了以下工具：

1. perplexity_ask - 直接向Perplexity AI发送问题
2. perplexity_search - 使用Perplexity AI执行搜索查询

更改模型

两个工具都支持Perplexity的以下模型：

• sonar-reasoning（默认）- Perplexity的推理焦点模型，最适合通用问题
• sonar-pro - 增强型模型，改进了专业用例的能力
• sonar-deep-research - 专门用于深入研究和复杂查询

在使用工具时指定模型，请在请求中包含model参数：

使用 sonar-deep-research询问Perplexity：量子计算的最新进展是什么？

您还可以自定义系统提示和最大令牌数：

使用 sonar-pro 通过 Perplexity 搜索，系统提示为 "You are a helpful research assistant"，最大令牌数为2000：可再生能源的最新发展

工具响应格式

服务器遵循MCP规范的工具响应格式：

{
  content: [
    {
      type: "text",
      text: "Perplexity AI的回答内容"
    }
  ],
  isError: false // 或true如果发生错误
}

Windsurf集成

在Windsurf中设置

1. 构建服务器：

   npm run build
   

2. 打开Windsurf并导航到设置

3. 找到“AI设置”或“模型上下文协议”部分

4. 添加一个新的MCP服务器，使用以下详细信息：

   • 名称：Perplexity Insight
   • 类型：本地进程
   • 命令：指向您的Node.js可执行文件的路径
   • 参数：指向您编译的index.js文件的路径
   • 工作目录：指向您的项目目录
   • 环境变量：确保包含PERPLEXITY_API_KEY=your_api_key_here

5. 启用服务器并根据需要重启Windsurf

示例配置

以下是mcp_config.json文件示例配置：

"perplexity-ask": {
  "command": 指向Node.js可执行文件的路径,
  "args": [
    "node",
    "index.js"
  ],
  "env": {
    "PERPLEXITY_API_KEY": "your_api_key_here"
  }
}

故障排除

• 问题：无法连接到Perplexity API
  解决方法：检查API密钥是否正确，并确保互联网连接正常。

开发

npm run dev

许可证

MIT许可证