Perplexity MCP Server

Perplexity MCP Zerver

一个精简的研究服务，通过 Perplexity 的 Web 界面实现模型上下文协议（MCP），提供 AI 驱动的研究能力。

研究能力

• 智能 Web 研究：搜索并总结内容，不受 API 限制
• 持久化对话：通过本地 SQLite 聊天记录存储保持上下文
• 内容提取：提取干净的文章内容，并解析 GitHub 仓库
• 开发者工具：获取文档、发现 API、分析代码
• 无密钥运行：通过浏览器自动化替代 API 密钥要求

---

可用工具

搜索（search）

执行可配置深度的研究查询
返回原始文本结果

获取文档（get_documentation）

获取包含示例的技术文档
返回结构化文档

查找 API（find_apis）

发现适用于开发需求的 API
返回 API 列表和说明

检查已弃用代码（check_deprecated_code）

分析代码片段，查找过时模式
返回分析报告

提取 URL 内容（extract_url_content）

解析 Web 内容并自动处理 GitHub
返回结构化内容元数据

聊天（chat_perplexity）

支持上下文历史记录的持久化对话
以 JSON 格式返回对话状态

---

开始使用

前提条件

• Bun 运行时
• Node.js 18+（用于 TypeScript 编译）

安装

git clone https://github.com/wysh3/perplexity-mcp-zerver.git
cd perplexity-mcp-zerver
bun install
bun run build

配置

添加到 MCP 配置文件：

{
  "mcpServers": {
    "perplexity-server": {
      "command": "bun",
      "args": ["/absolute/path/to/build/main.js"],
      "timeout": 300
    }
  }
}

使用

通过 MCP 客户端发起命令：

• “使用 perplexity 研究量子计算的最新进展”
• “向 perplexity-server 查询 React 18 文档”
• “与 perplexity 开始关于神经网络的对话”

---

🔐 Pro 账户支持（可选）

使用 Perplexity Pro 订阅，以访问更好的模型（GPT-5.1、Claude Sonnet 4.5）并获得更高的使用限额。

一次性设置

bun run build
bun run login

浏览器窗口将会打开。使用电子邮件登录（兼容性最佳），然后关闭浏览器。会话现已保存！

注意：Google/SSO 登录可能可用，但通过浏览器自动化时，电子邮件登录更可靠。

环境变量

变量	默认值	说明
PERPLEXITY_BROWSER_DATA_DIR	~/.perplexity-mcp	浏览器配置文件目录
PERPLEXITY_PERSISTENT_PROFILE	true	设置为 false 可使用匿名模式

---

技术对比

功能	此实现	传统 API
身份验证	无需身份验证	API 密钥
费用	免费	按用量计费
数据隐私	本地处理	远程服务
GitHub 集成	原生支持	有限
历史记录持久化	SQLite 存储	基于会话

---

故障排除

服务连接问题

1. 确认配置中使用了绝对路径
2. 使用 node -v 确认已安装 Node.js
3. 确保构建成功完成

内容提取

• GitHub 路径必须使用完整的仓库 URL
• 在源配置中调整链接递归深度

---

起源与许可证

基于 - DaInfernalCoder/perplexity-researcher-mcp
重构自 - sm-moshi/docshunter

采用 GNU GPL v3.0 许可证 - 查看许可证

---

本项目通过浏览器自动化与 Perplexity 交互。请负责任且合乎道德地使用。稳定性取决于 Perplexity 网站的一致性。仅供教育用途。