perplexity-user-mcp MCP 服务说明文档
1. 服务概述一句话简介通过长期Perplexity浏览器会话为15 IDE提供Perplexity AI搜索和回答能力的MCP服务器无需API密钥支持Free/Pro/Max计划服务名称perplexity-user-mcp版本号实验性项目活跃开发中开发者/提供方Automations-Project协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点长期浏览器会话通过patchright自动化真实的Chromium浏览器维持长期Perplexity会话自动配置15 IDE支持VS Code、Cursor、Windsurf、Trae、Claude Desktop、Claude Code等VS Code扩展原生VS Code扩展包含嵌入式MCP守护进程和Webview仪表板无需API密钥使用您已登录的Perplexity账户Free/Pro/Max无需API密钥OAuth 2.1认证支持OAuth 2.1认证流程可插拔隧道支持Cloudflare Quick Tunnel和ngrok隧道配置文件管理支持多配置文件Cookie加密存储在vault中浏览器检测自动检测Chrome、Edge、Chromium、Brave等浏览器3. 使用场景描述该服务适合在什么情况下使用IDE内搜索在VS Code、Cursor等IDE中直接使用Perplexity AI进行搜索和问答代码辅助获取代码示例、调试帮助、最佳实践建议技术文档查询快速查找技术文档、API参考、教程问题解决获取错误解决方案、故障排除建议学习研究学习新技术、了解技术趋势无API密钥场景在没有API密钥的情况下使用Perplexity AI功能4. 接入方式4.1 服务端点perplexity-user-mcp提供两种使用方式VS Code扩展通过VS Code扩展市场安装嵌入式MCP守护进程独立npm包作为独立npm包安装支持任何MCP客户端传输方式stdio标准输入输出4.2 认证与权限服务通过您的Perplexity账户进行认证首次运行打开有头浏览器让您登录Perplexity账户Cloudflare TurnstilePerplexity在首次运行时提供Cloudflare Turnstile验证Cookie缓存登录后缓存cf_clearance和会话到~/.perplexity-mcp/Cookie加密Cookie加密存储在vault.enc中使用keytar和密码短语回退热重载任何修改配置文件状态的进程都会触发.reinit哨兵运行的MCP服务器会监视并热重载4.3 数据格式服务支持以下数据格式输入自然语言查询、搜索请求输出Perplexity AI的搜索结果和回答配置JSON格式的MCP配置和规则集4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { perplexity: { command: npx, args: [-y, perplexity-user-mcp] } } }5. 接口定义5.1 支持的IDE和MCP客户端IDE/客户端安装方式支持方式Visual Studio CodeVS Code扩展市场原生扩展VS Code InsidersVS Code扩展市场原生扩展CursorOpen VSX或手动配置自动配置WindsurfOpen VSX或手动配置自动配置TraeOpen VSX或手动配置自动配置Claude Desktopnpm包手动配置Claude Codenpm包手动配置Clinenpm包手动配置Ampnpm包手动配置Codex CLInpm包手动配置5.2 环境变量变量描述PERPLEXITY_BROWSER_PATH浏览器可执行文件的绝对路径优先于检测PERPLEXITY_CHROME_PATHPERPLEXITY_BROWSER_PATH的旧别名PERPLEXITY_CONFIG_DIR覆盖~/.perplexity-mcp配置文件、vault、守护进程状态PERPLEXITY_HEADLESS_ONLY仅在缓存有效清除后使用无头模式6. 快速开始6.1 环境要求Node.js20版本npm启用workspacesPerplexity账户Free / Pro / Max计划浏览器Chrome、Edge、Chromium、Brave等自动检测6.2 安装步骤安装VS Code扩展# 从VS Code扩展市场安装 # 或从Open VSX安装 # 或从源码构建 git clone https://github.com/Automations-Project/VSCode-Perplexity-MCP.git cd VSCode-Perplexity-MCP npm install npm run build npm run package:vsix # 安装扩展 code --install-extension packages/extension/perplexity-vscode-.vsix使用独立npm包# 在MCP客户端配置中添加 { mcpServers: { perplexity: { command: npx, args: [-y, perplexity-user-mcp] } } }从源码运行git clone https://github.com/Automations-Project/VSCode-Perplexity-MCP.git cd VSCode-Perplexity-MCP npm install npm run build # shared → mcp-server → webview → extension npm test # vitest across all packages7. 注意事项重要提示非官方项目这是社区维护的非官方Perplexity集成与Perplexity AI, Inc.无任何关联实验性质项目处于活跃开发中不适合生产使用API、工具和行为可能随时更改服务条款风险此项目通过自动化已登录的Perplexity浏览器会话工作可能被视为自动化访问/抓取/技术滥用Perplexity可能随时更改或阻止此行为账户风险使用此项目可能导致Perplexity账户被限流、暂停或终止无担保软件按原样提供基于实验基础不提供任何担保许可协议MIT许可证配置文件位置~/.perplexity-mcp/可通过PERPLEXITY_CONFIG_DIR覆盖首次登录首次运行时会打开有头浏览器让您登录之后可使用PERPLEXITY_HEADLESS_ONLY1仓库结构packages/shared消息契约、IdeTarget/DashboardState类型、自动配置标记packages/mcp-serverPerplexity MCP运行时独立发布为perplexity-user-mcppackages/webviewReact 19 Vite Tailwind v4 zustand仪表板packages/extensionVS Code扩展主机注册MCP服务器、拥有webview、自动配置架构要点捆绑MCP扩展将MCP服务器捆绑到dist/mcp/server.mjs外部依赖单独提供守护进程可插拔隧道长期HTTP MCP服务器支持OAuth 2.1和可插拔隧道cf-quick和ngrok浏览器检测和下载管理器自动检测浏览器管理patchright Chromium下载