MCP Perplexity Server

🚀 智能代碼分析與調試的 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)

服務器將提供：

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

🔧 技術細節

安全

• 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 檢查器進行調試。

貢獻指南

1. 叉取倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m 'Add some amazing feature')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 打開 Pull Request。