Perplexity Insight

🚀 perplexity-insight-MCP服务端

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

🚀 快速开始

本项目是一个与Perplexity AI接口交互的MCP服务器，能借助标准化模型上下文协议实现高级问题解答。以下是快速开启使用的步骤：

1. 完成安装要求，确保具备Node.js 18+和Perplexity API密钥。
2. 按照安装步骤执行npm install完成依赖安装。
3. 创建.env文件并配置PERPLEXITY_API_KEY。
4. 运行npm start启动服务器。

✨ 主要特性

• 无缝集成：与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许可证。