AI搜索与文件分析服务器

困惑MCP服务器

为Claude Code带来困惑的MCP服务器——基于人工智能的网络搜索、深入研究、推理、头脑风暴、代码审查、解释和文件分析。所有这些都有实时的网络基础和引用。支持声纳、声纳Pro、声纳推理Pro和声纳深度研究模型。

快速开始

步骤1：获取API密钥

1. 首选 困惑API设置
2. 创建帐户或登录
3. 生成API密钥
4. 复制密钥（您将在步骤3中需要它）

步骤2：安装先决条件

• Node.js 18+ - 点击此处下载
• Claude 代码命令行工具 - 安装指南

步骤3：安装MCP服务器

3.1克隆存储库

git clone https://github.com/wynandw87/claude-code-perplexity-mcp.git
cd claude-code-perplexity-mcp

3.2安装依赖项

macOS/Linux/Windows：

npm install

注： 安装依赖项后，服务器将在一个步骤中自动构建。

3.3使用克劳德代码注册

选择您的安装范围：

替换 YOUR_API_KEY 使用您的实际困惑API密钥，并使用 dist/index.js.

提示： 要获取完整路径，请从克隆的目录运行以下命令：

• macOS/Linux： echo "$(pwd)/dist/index.js"
• 窗户： echo %cd%\dist\index.js

macOS/Linux：

claude mcp add -s user Perplexity -e PERPLEXITY_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows（CMD）：

claude mcp add -s user Perplexity -e "PERPLEXITY_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows（PowerShell）：

claude mcp add -s user Perplexity -e "PERPLEXITY_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

替代方案：使用安装脚本

安装脚本自动处理依赖关系的安装、构建和注册。

macOS/Linux：

chmod +x setup.sh
./setup.sh YOUR_API_KEY

Windows（PowerShell）：

.\setup.ps1 -ApiKey YOUR_API_KEY

或者使用npm助手（如果在环境中设置了API密钥）：

export PERPLEXITY_API_KEY=YOUR_API_KEY
npm run install:claude

步骤4：重新启动Claude代码

关闭并重新打开Claude Code以使更改生效。

步骤5：验证安装

claude mcp list

你应该看看 Perplexity 以“已连接”状态列出。

特性

搜索与研究

• 网络搜索 (search_web)-基于人工智能的网络搜索，具有域名过滤、近因过滤和详细引用功能
• 深入研究 (deep_research)-使用声纳深度研究进行详尽的多步骤研究
• 推理+搜索 (search_with_reasoning)-结合实时网络搜索的逐步推理
• 原始搜索 (search)-使用标题、URL和片段对搜索结果进行排名

文本与分析

• 通用查询 (ask)-基于网络的问答，自动引用
• 头脑风暴 (brainstorm)-基于实时网络数据的创造性思维
• 代码审查 (code_review)-基于网络的最佳实践的代码分析
• 解释 (explain)-清晰的概念解释，基于网络的准确性

文件

• 文件上传 (upload_file)-上传文档和图像进行分析（文本文件、图像）

用法

安装后，使用触发器短语调用Perplexity：

或者自然地问：

• “问问困惑，Next.js的最新最佳实践是什么”
• “让困惑检查此代码是否存在安全问题”
• “关于扩展策略的困惑头脑风暴”
• “困惑——在网上搜索人工智能的最新消息”
• “用困惑深入研究WebAssembly的状态”
• “通过微服务与单体架构的权衡来解释困惑”
• “将此CSV上传到Perplexity，并要求其汇总数据”

工具参考

问

基于网络的答案和引用的查询困惑。

参数：

• prompt （string，必填）-问题或指令
• model （字符串，可选）-模型标识符（默认为 sonar-pro)
• search （布尔值，可选）-启用网络搜索基础（默认值： true)

搜索web

使用域名和最近度过滤搜索网络。一流的人工智能搜索。

参数：

• query （字符串，必填）-搜索查询或问题
• allowed_domains （string[]，可选）-仅包含这些域的结果（最多5个）
• excluded_domains （string[]，可选）-从搜索中排除这些域（最多5个）
• recency （字符串，可选）- "hour", "day", "week", "month"
• detail （字符串，可选）-搜索深度： "low", "medium", "high"

深度搜索

对一个主题进行详尽、多步骤的研究。可能需要30-60秒以上。

参数：

• query （string，必填）-要调查的研究问题或主题

搜索_无理由

逐步推理与实时网络搜索相结合。

参数：

• prompt （string，必填）-需要深入推理的问题
• allowed_domains （string[]，可选）-仅包含这些域的结果（最多5个）
• recency （字符串，可选）- "hour", "day", "week", "month"

搜索

无需人工智能合成即可获得原始排名搜索结果。

参数：

• query （字符串，必填）-搜索查询
• max_results （整数，可选）-结果数量（1-50，默认值：10）
• domain_filter （string[]，可选）-仅筛选到这些域（最多5个）
• recency （字符串，可选）- "hour", "day", "week", "month"

代码查看

使用基于网络的当前最佳实践进行代码审查。

参数：

• code （string，必填）-要查看的代码
• focus （字符串，可选）-特定关注领域（例如，“安全”、“性能”）

头脑风暴

根据实时网络数据和当前趋势进行头脑风暴。

参数：

• topic （string，必填）-头脑风暴的主题
• context （字符串，可选）-其他上下文

解释

清晰的解释，基于网络的准确性。

参数：

• concept （string，必填）-解释什么

上传文件

上传文档或图像以供分析。

参数：

• file_path （string，必填）-要上传的文件的绝对路径
• query （string，可选）-上传后立即询问文件的问题
• model （字符串，可选）-模型标识符（默认为 sonar-pro)

支持文本文件(.txt, .md, .py, .js, .ts, .csv, .json等）和图像(.png, .jpg, .gif, .webp).

支持的型号

所有型号都有128K上下文窗口和实时网络基础。

配置

环境变量

运作原理

此MCP服务器直接使用本机的困惑REST API（聊天完成和搜索端点） fetch.不依赖SDK--只是 @modelcontextprotocol/sdk 和 zod。它通过stdio传输连接到Claude Code。

提供的工具：

故障排除

修复API密钥

如果您输入了错误的API密钥，请删除并重新安装：

claude mcp remove Perplexity

然后使用上述步骤3.3中的命令重新安装（使用与最初安装时相同的作用域）。

MCP服务器未显示

检查服务器是否已安装：

claude mcp list

如果未列出，请按照步骤3进行安装。

服务器无法启动

1. 验证您的API密钥 有效期为 困惑API设置

2. 检查Node.js版本 （需要18+）：

   复制

   node --version
   

3. 确保服务器已构建 --如果 dist/index.js 不见了，快跑 npm install 再次

连接错误

1. 检查一下 dist/index.js 存在 --如果没有，运行 npm install
2. 验证路径是否为绝对路径 在你的 claude mcp add 命令
3. 重新启动Claude代码 在任何配置更改后

超时错误

• 深度研究使用5倍的基本超时时间——预计需要更长的时间
• 推理和搜索工具使用3倍基本超时
• 增加 PERPLEXITY_TIMEOUT 慢速连接的环境变量

深入研究需要太长时间

sonar-deep-research 综合研究可能需要30-60秒以上。这很正常——它正在对许多来源进行多步骤调查。

查看当前配置

claude mcp list

贡献

欢迎拉取请求！请保持简单，对初学者友好。

许可证

麻省理工学院

专为Claude Code社区打造