Perplexity Advanced MCP

🚀 Perplexity Advanced MCP

本ツールパッケージ「Perplexity Advanced MCP」は、OpenRouterとPerplexityのサービスを統合することで、拡張されたモデルコンテキストプロトコル（MCP）機能を提供します。簡単なクエリや複雑な推論に対応し、コンテキスト入力としてファイルを添付することも可能です。

🚀 クイックスタート

本ツールパッケージは、OpenRouterとPerplexityのサービスを統合し、拡張されたモデルコンテキストプロトコル（MCP）機能を提供します。簡単なクエリや複雑な推論に対応し、コンテキスト入力としてファイルを添付することができます。

✨ 主な機能

MCP検索ツール

このパッケージには、ask_perplexity関数で実装されたMCP検索ツールが統合されています。以下の機能をサポートしています。

• 簡単なクエリ：迅速な応答を提供します。
• 複雑な推論：ファイル添付（XML形式が必要）をサポートします。

📦 インストール

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に基づいて構築されており、使いやすいコマンドラインインターフェースを提供します。

📚 ドキュメント

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. AIの十分なテストを支援するために、MCPサーバーを起動/停止する。
2. 問題を特定するために、エラーログをコピーして提供する。
3. Python MCP SDKの関連ドキュメントとサンプルのリンクを提供する。
4. 期待通りでないコードに対して修正提案を行う。

本プロジェクトの開発の原動力は、ソフトウェアエンジニアリング分野におけるAIツールの可能性を探求することです。特に、音声入力とLLMを組み合わせることで、コーディング体験を再定義することを目指しています。現在はまだ初期段階ですが、この方向が開発者により効率的で自然なプログラミング方法をもたらすと信じています。

もしこのプロジェクトに興味があるか、何か質問があれば、随時更新をお楽しみください！