Perplexity Advanced MCP

🚀 項目標題 - Perplexity Advanced MCP

本項目是名為“Perplexity Advanced MCP”的工具包，它集成了 OpenRouter 和 Perplexity 的服務，提供增強的模型上下文協議（MCP）功能。支持簡單查詢和複雜推理，還能附加文件作為上下文輸入，為用戶帶來更強大的使用體驗。

🚀 快速開始

本項目是一個名為“Perplexity Advanced MCP”的工具包，旨在通過集成 OpenRouter 和 Perplexity 的服務，提供增強的模型上下文協議（MCP）功能。該工具包支持簡單查詢和複雜推理，並允許附加文件作為上下文輸入。

📦 安裝指南

使用Smithery快速安裝

通過 Smithery 平臺可實現一鍵式安裝：

npx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude

使用uvx快速啟動

使用 uvx 工具啟動MCP服務器：

uvx perplexity-advanced-mcp -o <openrouter_api_key> # 或 -p <perplexity_api_key>

您也可以通過環境變量配置API密鑰：

export OPENROUTER_API_KEY="your_key_here"
# 或
export PERPLEXITY_API_KEY="your_key_here"

uvx perplexity-advanced-mcp

⚠️ 重要提示

• 同時提供OpenRouter和Perplexity API密鑰會導致錯誤。
• 當命令行參數與環境變量同時存在時，命令行參數優先。

該CLI工具基於 Typer 構建，提供了友好直觀的命令行交互體驗。

✨ 主要特性

MCP搜索工具

本包集成了一款MCP搜索工具，通過 ask_perplexity 函數實現。它支持以下功能：

• 簡單查詢：提供快速響應。
• 複雜推理：支持文件附件（需XML格式）。

📚 詳細文檔

配置指南

API密鑰配置

您可選擇配置OpenRouter或Perplexity的API密鑰，具體方式如下：

• 命令行參數：-o <openrouter_api_key> 或 -p <perplexity_api_key>。
• 環境變量：OPENROUTER_API_KEY 或 PERPLEXITY_API_KEY。

模型映射

在 src/perplexity_advanced_mcp/config.py 文件中，查詢類型與模型的映射關係如下：

OpenRouter模型：

• 簡單查詢：perplexity/sonar。
• 複雜推理：perplexity/sonar-reasoning。

Perplexity模型：

• 簡單查詢：sonar-pro。
• 複雜推理：sonar-reasoning-pro。

項目背景與開發理念

本項目的靈感來源於個人對“vibe coding”趨勢的興趣探索。藉助 Cline + Cursor IDE，95%以上的代碼都是通過語音輸入（經 Wispr Flow 轉錄）生成的。項目結構和代碼均由AI協助完成。

從項目搭建到文件組織，所有代碼均通過LLM自動生成並審核。包括GitHub Actions的工作流和發佈流程等也都交由Cursor自動處理。作為人類開發者，主要工作如下：

1. 啟動/停止MCP服務器以協助AI進行充分測試。
2. 複製並提供錯誤日誌以便排查問題。
3. 提供 Python MCP SDK 的相關文檔和示例鏈接。
4. 對不符合預期的代碼提出修改建議。

項目意義

本項目的開發初衷是探索AI工具在軟件工程領域的潛力，尤其是通過語音輸入與LLM結合的方式，重新定義編碼體驗。儘管目前仍處於初期階段，但我們相信這一方向將為開發者帶來更高效、更自然的編程方式。

如果您對這個項目感興趣或有任何疑問，請隨時關注我們的更新！