🚀 perplexity MCP 服务器

本项目是一个基于 Model Context Protocol (MCP) 的服务器，借助 Perplexity AI 的 API 实现智能代码分析与调试功能，并且能与 Claude 桌面客户端实现无缝集成。

✨ 主要特性

• 智能错误分析：能够详细剖析编码错误，精准找出错误根源。
• 模式检测：自动识别常见错误模式，并给出针对性的解决办法。
• 全面解决方案：提供分步骤的修复方案，包含多种实现替代方案。
• 最佳实践：涵盖编码标准和错误预防技巧。
• Python 支持：专门处理 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)

服务器会提供以下内容：

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

📦 安装指南

先决条件

• 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：从源代码安装

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 构建并全局安装：

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"
      }
    }
  }
}

🔧 技术细节

项目结构

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

可用脚本

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

贡献指南

1. 叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个拉取请求

📄 许可证

此项目根据 MIT 许可证发布，详细信息请参见 LICENSE 文件。

🏆 致谢

• 感谢 Perplexity AI 提供强大的 API
• 使用 Model Context Protocol 构建