JinDaGe - mcp-perplexity-server MCP Details

article

README

🚀 智能代码分析与调试的 perplexity MCP 服务器

这是一个借助 Perplexity AI API 实现智能代码分析和调试功能的 Model Context Protocol (MCP) 服务器，它能够与 Claude 桌面客户端实现无缝集成。

🚀 快速开始

本服务器使用 Perplexity AI API 提供智能代码分析和调试功能，与 Claude 桌面客户端无缝集成。你可以通过以下步骤开始使用：提出关于代码错误的问题，附上代码片段，服务器将提供详细的分析和解决方案。

✨ 主要特性

智能错误分析：详细分解编码错误并提供根本原因分析。
模式检测：自动识别常见错误模式并提供针对性解决方案。
全面解决方案：分步修复方案，附带多种实现替代方法。
最佳实践：包含编码标准和错误预防技巧。
Python 支持：专门处理 Python 类型错误和常见编码问题。

💻 使用示例

基础用法

提出如下问题：

"如何修复这个 TypeError"
"是什么导致了这个错误信息？"
"如何修复这段代码？"

附上你的代码片段以获得针对性分析：

def calculate_total(items):
    total = 0
    for item in items:
        total = total + item['price']  # TypeError: string + int

data = [
    {'name': 'Book', 'price': '10'},
    {'name': 'Pen', 'price': '2'}
]

result = calculate_total(data)

服务器将提供：

错误的根本原因分析
分步解决方案与代码示例
预防类似问题的最佳实践
替代实现方法

📦 安装指南

先决条件

Node.js 18 或更高版本
Perplexity AI API 密钥

选项 1: 从 npm 安装（推荐）

# 使用 npm
npm install -g perplexity-mcp

# 或使用仓库直接安装
npm install -g git+https://github.com/yourusername/perplexity-mcp.git

选项 2: 从源代码安装

克隆仓库:

git clone https://github.com/yourusername/perplexity-server.git
cd perplexity-server

安装依赖项:

npm install

构建并全局安装:

npm run build
npm install -g .

配置 Claude 桌面客户端

添加到你的 Claude 桌面配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "perplexity": {
      "command": "perplexity-mcp",
      "args": [],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

或如果从源代码安装：

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-server/build/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔧 技术细节

安全

API 密钥在 Claude 桌面配置文件中安全存储。
密钥作为环境变量传递给服务器。
不在仓库中存储任何敏感数据。
服务器期望 API 密钥由环境提供。

项目结构

perplexity-server/
├── src/
│   └── index.ts      # 主服务器实现文件
├── package.json      # 项目配置文件
└── tsconfig.json    # TypeScript 配置文件

可用脚本

npm run build：构建项目。
npm run watch：监控更改并自动重建。
npm run prepare：准备发布包。
npm run inspector：运行 MCP 检查器进行调试。

贡献指南

叉取仓库。
创建功能分支 (git checkout -b feature/amazing-feature)。
提交更改 (git commit -m 'Add some amazing feature')。
推送到分支 (git push origin feature/amazing-feature)。
打开 Pull Request。

mcp-perplexity-server