Perplexity MCP

🚀 Perplexity MCP Server

Model Context Protocol (MCP)サーバーで、Perplexity AIの検索強化言語モデルをClaude Desktopと統合し、異なるユースケースに対応するための複雑度が段階的に高くなる3つのツールを提供します。

✨ 主な機能

🔍 3つの複雑度レベル

• perplexity_small: sonar - proモデルを使用した高速クエリ
• perplexity_medium: sonar - reasoning - proを使用した強化された推論
• perplexity_large: sonar - deep - researchを使用した深い調査

🚀 開発向けに最適化

• クリーンなレスポンス（思考トークンが自動的に削除される）
• 包括的なエラーハンドリング
• デバッグ用の詳細なロギング
• 信頼性の高いFastMCPで構築

🔧 最新のPythonスタック

• 高速な依存関係管理のためのUV
• 最新のHTTPクライアント機能を持つHTTPX
• コードベース全体に型ヒントがある
• 包括的なテストスイート

🚀 クイックスタート

前提条件

• Python 3.11以上
• UVパッケージマネージャー
• Perplexity APIキー
• Claude Desktop

インストール

1. リポジトリをクローンする

   git clone <repository-url>
   cd Perplexity_MCP
   

2. 依存関係をインストールする

   uv sync
   

3. 環境を設定する

   echo "PERPLEXITY_API_KEY=your_api_key_here" > .env
   

4. インストールをテストする

   uv run python tests/tests.py small
   

Claude Desktopとの統合

1. UVのパスを見つける

   which uv
   # 出力例: /Users/username/.local/bin/uv
   

2. Claude Desktopを設定する

   ~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します。

   {
     "mcpServers": {
       "perplexity-mcp": {
         "command": "/Users/username/.local/bin/uv",
         "args": [
           "--directory", 
           "/path/to/your/Perplexity_MCP",
           "run",
           "python",
           "server.py"
         ]
       }
     }
   }
   

3. Claude Desktopを再起動する

   Claude Desktopを完全に終了して再起動し、新しいMCPサーバーを読み込みます。

💻 使用例

基本的な使用法

Claude Desktopで設定が完了すると、会話の中でこれらのツールを使用できます。

迅速な事実クエリ:

Use perplexity_small to find: "What is the latest Python version?"

技術分析:

Use perplexity_medium to explain: "Compare REST vs GraphQL performance characteristics"

深い調査:

Use perplexity_large to research: "Comprehensive analysis of quantum computing trends in 2024"

ツールの仕様

応答形式

すべてのツールはクリーンで構造化された応答を返します。

{
  "content": "The AI response with thinking tokens removed",
  "citations": ["https://source1.com", "https://source2.com"]
}

📚 ドキュメント

プロジェクト構造

Perplexity_MCP/
├── server.py                # 3つのツールを持つFastMCPサーバー
├── client.py                # Perplexity APIラッパー  
├── config.py                # 設定とツールの設定
├── __init__.py              # パッケージエクスポート
├── pyproject.toml           # UVプロジェクト設定
├── tests/
│   ├── tests.py             # 個々のツールのテストスクリプト
│   └── test_logs/           # テスト結果とログ
└── Notes/
    ├── explanations.md      # 技術的な詳細説明
    └── questions.txt        # 開発に関する質問

テストの実行

API統合を検証するために個々のツールをテストします。

# 各ツールを独立してテストする
uv run python tests/tests.py small    # sonar - proモデルをテストする
uv run python tests/tests.py medium   # sonar - reasoning - proをテストする
uv run python tests/tests.py large    # sonar - deep - researchをテストする（実行時間が長い）

# 結果はtests/test_logs/に保存され、詳細な応答分析が行われます

開発環境の設定

1. 開発用の依存関係をインストールする

   uv sync --all-groups
   

2. MCPサーバーをローカルで実行する（デバッグ用）

   uv run python server.py
   

3. コード品質をチェックする

   uv run ruff check .
   uv run black .
   

設定

環境変数

ツールの設定

ツールはconfig.pyで設定されています。

TOOL_CONFIGS = {
    "small": {
        "model": "sonar-pro"
    },
    "medium": {
        "model": "sonar-reasoning-pro", 
        "reasoning_effort": "medium",
        "web_search_options": {"search_context_size": "medium"}
    },
    "large": {
        "model": "sonar-deep-research",
        "reasoning_effort": "high",
        "web_search_options": {"search_context_size": "high"}
    }
}

トラブルシューティング

一般的な問題

インポートエラー

ModuleNotFoundError: No module named 'client'

• プロジェクトのルートディレクトリから実行していることを確認してください。
• UVが正しい仮想環境を使用していることを確認してください。

APIキーの問題

Error: PERPLEXITY_API_KEY environment variable is required

• .envファイルが存在し、APIキーが含まれていることを確認してください。
• Perplexityの設定ページでAPIキーが有効であることを確認してください。

Claude Desktopの接続問題

• 設定内のUVパスを確認してください：which uv
• プロジェクトディレクトリのパスが絶対パスで正しいことを確認してください。
• Claude Desktopのログを確認して、具体的なエラーメッセージを確認してください。
• 設定を変更した後、Claude Desktopを完全に再起動してください。

応答時間が長い問題

• perplexity_largeは複雑なクエリで10 - 30分かかることがあります。
• より高速な応答が必要な場合は、perplexity_smallまたはperplexity_mediumを使用してください。
• ツールを選択する際に、クエリの複雑さを考慮してください。

デバッグモード

サーバーを直接実行することで詳細なロギングを有効にします。

uv run python server.py
# 詳細なロギング情報はstderr出力を確認してください

個々のコンポーネントをテストする

# API接続をテストする
uv run python -c "from client import PerplexityClient; print('✅ Client OK')"

# 設定をテストする
uv run python -c "from config import get_api_key; print('✅ API Key OK')"

# サーバーの起動をテストする
timeout 10s uv run python server.py || echo "Server started successfully"

貢献の方法

1. リポジトリをフォークする
2. 機能ブランチを作成する：git checkout -b feature - name
3. 変更を加え、十分にテストする
4. 必要に応じてドキュメントを更新する
5. プルリクエストを送信する

開発ガイドライン

• 既存のコードスタイル（Blackフォーマット、型ヒント）に従ってください。
• 新しい機能にはテストを追加してください。
• アーキテクチャに変更がある場合は、CLAUDE.mdを更新してください。
• 3つのPerplexityモデルすべてでテストしてください。
• MCPプロトコルに準拠していることを確認してください（クリーンなstdout）。

アーキテクチャ

重要な設計決定

• クラスベースのクライアント：効率的なリソース管理のためのシングルトンパターン
• 思考トークンの削除：<think>...</think>セクションを自動的にフィルタリングする
• 簡素化された応答：クリーンな統合のためにコンテンツと引用のみを返す
• エラー分離：例外をMCPレイヤーに伝播させない
• ロギング戦略：MCP準拠のためにすべてのデバッグ出力をstderrに出力する

依存関係

• mcp>=1.11.0 - FastMCPを備えたMCP Python SDK
• python - dotenv>=1.1.1 - 環境変数の管理
• httpx>=0.28.1 - タイムアウト処理を持つ最新のHTTPクライアント

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

謝辞

• Perplexity AI - 強力な検索強化言語モデルの提供
• Anthropic - ClaudeとMCPプロトコルの提供
• FastMCP - 優れたMCPフレームワークの提供

サポート

• APIに関する問題：Perplexityサポート
• MCPプロトコルに関する質問：MCPドキュメント
• Claude Desktopに関する問題：Claudeサポート

注意: このMCPサーバーは現在、ローカル開発と個人使用向けに最適化されています。将来のバージョンでは、より簡単なインストールと共有のためにPyPI配布オプションが追加される可能性があります。