使用说明
项目简介
Perplexity MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为 Claude 桌面客户端提供代码错误分析、模式识别、解决方案建议和最佳实践等功能。它通过 Perplexity AI 的强大 API,帮助开发者更高效地定位和解决代码问题。
主要功能点
- 智能错误分析:深入分析代码错误,提供根本原因、常见场景和技术背景分析。
- 模式检测:自动识别代码中的常见错误模式,并提供针对性的修复建议。
- 全面解决方案:提供修复错误的详细步骤,并给出多种可行的代码实现方案。
- 最佳实践:提供编码标准和错误预防技巧,帮助提升代码质量。
- Python 支持:特别针对 Python 语言的类型错误和常见编码问题进行了优化处理。
安装步骤
-
环境准备:
- 确保已安装 Node.js 18 或更高版本。
- 确保已拥有 Perplexity AI API 密钥 (PERPLEXITY_API_KEY)。
-
安装 Perplexity MCP Server:
- 推荐方式 (npm 全局安装):打开终端,运行命令 'npm install -g perplexity-mcp'。
- 从源代码安装:
- 克隆仓库到本地:'git clone https://github.com/PoliTwit1984/mcp-perplexity-server.git'
- 进入仓库目录:'cd mcp-perplexity-server'
- 安装依赖:'npm install'
- 构建项目:'npm run build'
- 全局安装:'npm install -g .'
服务器配置
要将 Perplexity MCP Server 与 Claude 桌面客户端连接,您需要配置 Claude 的配置文件。
-
打开 Claude 配置文件:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
-
配置 MCP 服务器: 在 'claude_desktop_config.json' 文件中,找到或创建 'mcpServers' 字段,并添加以下配置信息。请根据您的安装方式选择相应的配置。
如果使用 'npm install -g perplexity-mcp' 安装:
{ "mcpServers": { "perplexity": { "command": "perplexity-mcp", // 启动服务器的命令,假设 perplexity-mcp 已添加到全局路径 "args": [], // 启动参数,此处为空 "env": { "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY" // 替换为您的 Perplexity API 密钥 } } } }如果从源代码安装,并假设项目路径为 '/path/to/perplexity-server':
{ "mcpServers": { "perplexity": { "command": "node", // 使用 node 运行 JavaScript 文件 "args": ["/path/to/perplexity-server/build/index.js"], // 服务器入口文件路径,请替换为实际路径 "env": { "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY" // 替换为您的 Perplexity API 密钥 } } } }注意:请将 'YOUR_PERPLEXITY_API_KEY' 替换为您的实际 Perplexity API 密钥。
基本使用方法
-
启动服务器:
- 如果使用 'npm install -g perplexity-mcp' 安装,服务器会在 Claude 客户端尝试连接时自动启动。
- 如果从源代码安装,您可能需要手动运行服务器。在项目根目录下,运行 'npm run build' 和 'npm start' (如果 'package.json' 中有 start 脚本,或者直接使用 'node build/index.js')。但通常情况下,Claude 客户端会根据配置自动启动。
-
在 Claude 中提问:
- 在 Claude 桌面客户端中,向其提出关于代码错误或调试的问题。例如:
- "Fix this TypeError in my Python code"
- "What's causing this error message?"
- "How do I fix this code?"
- 在提问时,务必包含需要分析的代码片段。
- 在 Claude 桌面客户端中,向其提出关于代码错误或调试的问题。例如:
-
获取代码分析结果:
- Perplexity MCP Server 将接收 Claude 的请求,调用 Perplexity AI API 进行代码分析,并将分析结果以结构化的文本形式返回给 Claude 客户端。
- 返回结果通常包括错误根因分析、修复步骤、最佳实践建议和代码示例(修改前和修改后代码,以及其他解决方案)。
关键词
代码分析, 错误调试, 智能助手, Perplexity AI, Claude客户端
信息
分类
AI与计算