Perplexity Insight

🚀 perplexity-insight-MCP服务端

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

🚀 快速开始

本项目是一个用于与Perplexity AI交互的MCP服务器。要开始使用，您需要完成安装和环境变量的配置，之后就可以运行服务器并使用其提供的API工具进行问题查询。

✨ 主要特性

• 与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许可证。