使用说明

项目简介

Perplexity MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为 Claude 桌面客户端提供代码错误分析、模式识别、解决方案建议和最佳实践等功能。它通过 Perplexity AI 的强大 API,帮助开发者更高效地定位和解决代码问题。

主要功能点

  • 智能错误分析:深入分析代码错误,提供根本原因、常见场景和技术背景分析。
  • 模式检测:自动识别代码中的常见错误模式,并提供针对性的修复建议。
  • 全面解决方案:提供修复错误的详细步骤,并给出多种可行的代码实现方案。
  • 最佳实践:提供编码标准和错误预防技巧,帮助提升代码质量。
  • Python 支持:特别针对 Python 语言的类型错误和常见编码问题进行了优化处理。

安装步骤

  1. 环境准备

    • 确保已安装 Node.js 18 或更高版本。
    • 确保已拥有 Perplexity AI API 密钥 (PERPLEXITY_API_KEY)。
  2. 安装 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 的配置文件。

  1. 打开 Claude 配置文件

    • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
    • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
  2. 配置 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 密钥。

基本使用方法

  1. 启动服务器

    • 如果使用 'npm install -g perplexity-mcp' 安装,服务器会在 Claude 客户端尝试连接时自动启动。
    • 如果从源代码安装,您可能需要手动运行服务器。在项目根目录下,运行 'npm run build' 和 'npm start' (如果 'package.json' 中有 start 脚本,或者直接使用 'node build/index.js')。但通常情况下,Claude 客户端会根据配置自动启动。
  2. 在 Claude 中提问

    • 在 Claude 桌面客户端中,向其提出关于代码错误或调试的问题。例如:
      • "Fix this TypeError in my Python code"
      • "What's causing this error message?"
      • "How do I fix this code?"
    • 在提问时,务必包含需要分析的代码片段
  3. 获取代码分析结果

    • Perplexity MCP Server 将接收 Claude 的请求,调用 Perplexity AI API 进行代码分析,并将分析结果以结构化的文本形式返回给 Claude 客户端。
    • 返回结果通常包括错误根因分析、修复步骤、最佳实践建议和代码示例(修改前和修改后代码,以及其他解决方案)。

关键词

代码分析, 错误调试, 智能助手, Perplexity AI, Claude客户端

信息

分类

AI与计算