Perplexity Sonar MCP Server

Perplexity Sonar MCP サーバー

Perplexity の Sonar モデルの力を Claude Desktop やその他の MCP クライアントで活用できる MCP サーバーの実装です。従来の MCP サーバーとは異なり、この実装ではウェブ検索機能を備えた Perplexity の高度な AI モデルを利用できます。これにより、Claude は会話中にリアルタイムでウェブ検索を実行し、最新の情報を提供できます。

Perplexity Sonar MCP を選ぶ理由

• リアルタイムのウェブ検索：会話中にウェブ上の最新情報にアクセスできます
• 複数のモデル：ニーズに合わせてさまざまな Sonar モデルを選択できます
  • sonar：一般的な用途に適したバランスの取れたモデル
  • sonar-pro：複雑なタスクに対応する強化された機能
  • sonar-reasoning：論理的な推論と分析に特化
  • sonar-deep-research：包括的な引用を伴う詳細な調査
• 豊富なパラメーター：幅広いパラメーターでクエリを細かく調整できます
  • 検索ドメインと情報の新しさを制御
  • 応答形式（markdown/JSON）を調整
  • temperature とトークン生成を管理
  • 関連する質問と画像を取得
• シームレスな統合：Claude Desktop やその他の MCP クライアントでネイティブに動作します

要件

• Node.js 18.0.0 以降
• Perplexity API キー（https://www.perplexity.ai/account/api で取得）
• Claude Desktop（デスクトップ統合用）

Node.js のインストールを確認するには：

node --version  # Should be 18.0.0 or higher

Node.js がインストールされていない場合、または更新が必要な場合：

1. nodejs.org からダウンロードします
2. お使いのオペレーティングシステムのインストール手順に従います
3. インストール後、ターミナルを再起動します

使用方法

Claude Desktop での使用

1. Claude Desktop の設定ファイルを編集します：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 次の設定を追加します：

   {
     "mcpServers": {
       "perplexity": {
         "command": "npx",
         "args": [
           "-y",
           "@felores/perplexity-sonar-mcp"
         ],
         "env": {
           "PERPLEXITY_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

3. Claude Desktop を再起動します

スタンドアロンモード

HTTP/SSE に対応したスタンドアロンモードでサーバーを実行することもできます：

PERPLEXITY_API_KEY=your_api_key_here perplexity-sonar-mcp

これにより、デフォルトでポート 3000 でサーバーが起動します。別のポートを指定することもできます：

PERPLEXITY_API_KEY=your_api_key_here PORT=8080 perplexity-sonar-mcp

API リファレンス

このサーバーは次の MCP ツールを公開します：

perplexity-chat

パラメーター：

• model（任意）：使用するモデル（デフォルト："sonar"）
  • 選択肢：
    • sonar：一般的な用途に適したバランスの取れたモデル
    • sonar-pro：複雑なタスクに対応する強化された機能
    • sonar-reasoning：論理的な推論に特化
    • sonar-deep-research：引用を伴う詳細な調査
• messages：次の要素を含むメッセージオブジェクトの配列：
  • role："system" | "user" | "assistant"
  • content：文字列
• temperature（任意）：ランダム性を制御（0～2）
  • 値を低くすると（例：0.3）、より焦点を絞った応答になります
  • 値を高くすると（例：0.8）、より創造的な応答になります
• max_tokens（任意）：生成するトークンの最大数
• top_p（任意）：nucleus sampling による多様性を制御（0～1）
• search_domain_filter（任意）：引用元を限定するドメインの配列
  • 例：["wikipedia.org", "github.com"]
• return_images（任意）：検索結果の画像を返すかどうか
• return_related_questions（任意）：関連する質問を返すかどうか
• search_recency_filter（任意）：情報の新しさで検索結果を絞り込む
  • 選択肢："month", "week", "day", "hour"
• top_k（任意）：検索対象とする検索結果の最大数
• stream（任意）：応答をストリーミングするかどうか
• presence_penalty（任意）：トークンの出現にペナルティを適用
• frequency_penalty（任意）：トークンの頻度にペナルティを適用
• output_format（任意）：応答形式（"json" または "markdown"、デフォルト："markdown"）

クエリの例

このサーバーを使用して Claude に尋ねられる質問の例を以下に示します。

1. デフォルトモデルでの基本的な検索： 「量子コンピューティングの最新動向を教えてください。」

2. 引用付きの詳細な調査： 「sonar-deep-research を使って、核融合エネルギーの現状を説明してください。」

3. ドメインを指定した検索： 「arxiv.org と nature.com のみを対象に、LLM に関する最近の論文を検索してください。」

4. 最近のニュース検索： 「今週、AI 研究で何がありましたか？ search_recency_filter: 'week' を使用してください」

開発

1. リポジトリをクローンします：

   git clone https://github.com/felores/perplexity-sonar-mcp.git
   cd perplexity-sonar-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 開発モードで実行します：

   npm run dev
   

トラブルシューティング

問題が発生した場合：

1. API キーが正しいことを確認します
2. Node.js のバージョンに互換性があることを確認します
3. Claude Desktop のログでエラーを確認します：
   • macOS：~/Library/Logs/Claude/mcp.log
   • Windows：%APPDATA%\Claude\logs\mcp.log
4. 問題を切り分けるため、スタンドアロンモードで実行してみます

ライセンス

MIT