Perplexity Insight MCP Server

困惑洞察MCP服务器

MCP服务器实现，用于与困惑AI API接口，通过标准化模型上下文协议提供高级问答功能。

特性

• 与困惑AI API无缝集成
• 支持不同的困惑模型（声纳推理、声纳专业、声纳深度研究）
• 可定制的系统提示和用户查询
• 正确的错误处理和响应格式
• 速率限制保护
• 与Windsurf IDE轻松集成

需求

• Node.js 18+
• 困惑API键

安装

npm install

环境变量

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

PERPLEXITY_API_KEY=your_api_key_here

用法

运行服务器：

npm start

API工具

服务器公开了以下工具：

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

更改模型

这两个工具都支持以下困惑模型：

• sonar-reasoning （默认）-困惑的推理模型，最适合一般问题
• sonar-pro -增强了模型，提高了专业用例的能力
• sonar-deep-research -专门用于深入研究和复杂查询

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

Ask Perplexity using sonar-deep-research: What are the latest advancements in quantum computing?

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

Search with Perplexity using sonar-pro with system prompt "You are a helpful research assistant" and max tokens 2000: Latest developments in renewable energy

工具响应格式

服务器遵循MCP规范进行工具响应：

{
  content: [
    {
      type: "text",
      text: "Response content from Perplexity AI"
    }
  ],
  isError: false // or true if an error occurred
}

Windsurf集成

在Windsurf设置

1. 构建服务器：

   npm run build

1. 打开Windsurf并导航到设置

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

1. 添加具有以下详细信息的新MCP服务器：

- 名字：困惑洞察 - 类型：本地流程 - 命令：Node.js可执行文件的路径 - 参数：编译路径 index.js 文件 - 工作目录：项目目录的路径 - 环境变量：确保包括 PERPLEXITY_API_KEY=your_api_key_here

1. 启用服务器，必要时重新启动Windsurf

配置示例

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

"perplexity-ask": {
  "command": "node",
  "args": [
    "/path/to/perplexity-insight-MCP/dist/index.js"
  ],
  "cwd": "/path/to/perplexity-insight-MCP",
  "env": {
    "PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

替换 /path/to/perplexity-insight-MCP 使用安装目录的实际路径，并使用实际的困惑API密钥。

在风浪中运用困惑

• 使用AI助手面板提问，这些问题将指向困惑
• 对于网络搜索，在查询中包含“搜索”等特定术语
• 要更改模型，请在查询中包含模型名称，如“更改模型”部分所示
• Windsurf将根据您的查询自动使用相应的困惑工具

发展

对于当地发展：

npm run dev

故障排除

如果遇到MCP服务器问题：

1. 检查您的API密钥是否有效，并在 .env 文件
2. 验证响应格式是否符合MCP规范
3. 在服务器日志中查找任何错误消息
4. 确保Windsurf已正确配置以使用MCP服务器

许可证

麻省理工学院