Perplexity MCP サーバー

クエリの意図に基づいて自動的にモデルを選択する Perplexity の API を使用して Web 検索機能を提供する MCP サーバー。

前提条件

• Node.js (v14以上)

• Perplexity API キー ( https://www.perplexity.ai/settings/apiで取得)

• クロードデスクトップアプリ

Related MCP server: Perplexity MCP Server

インストール

Git経由でインストール

1. このリポジトリをクローンします:

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

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

   npm install

3. サーバーを構築します。

   npm run build

構成

1. https://www.perplexity.ai/settings/apiから Perplexity API キーを取得します。

2. ~/Library/Application Support/Claude/claude_desktop_config.jsonにある Claude の設定ファイルにサーバーを追加します。

{
  "mcpServers": {
    "perplexity-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/perplexity-mcp/build/index.js"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here",
        "PERPLEXITY_MODEL": "sonar"
      }
    }
  }
}

/absolute/path/toリポジトリのクローンを作成した実際のパスに置き換えます。

利用可能なモデル

サーバーはクエリの意図に基づいた自動モデル選択をサポートするようになりましたが、 PERPLEXITY_MODEL環境変数を使用してデフォルトのモデルを指定することもできます。利用可能なオプション：

• sonar-deep-research - 分野を超えた広範な調査と専門家レベルの分析に特化しています

• sonar-reasoning-pro - 高度な論理的推論と複雑な問題解決に最適化されています

• sonar-reasoning - バランスの取れたパフォーマンスで推論タスクを実行するために設計されています

• sonar-pro - 優れた検索機能と引用密度を備えた汎用モデル

• sonar - 簡単なクエリを高速かつ効率的に実行

デフォルトのモデル (環境変数で指定) は、自動モデル選択のベースラインとして使用されます。

最新のモデルの価格と在庫状況については、 https://docs.perplexity.ai/guides/pricingをご覧ください。

使用法

サーバーを設定してClaudeを再起動すれば、Claudeに情報を検索するよう指示するだけで済みます。例えば：

• 「SpaceXの最新ニュースは何ですか？」

• 「シカゴの最高のレストランを検索」

• 「ジャズ音楽の歴史に関する情報を見つける」

• 「最近の AI 開発に関する詳細な調査分析が必要です」（sonar-deep-research を使用）

• 「この複雑な問題を論理的に理解するのを手伝ってください」（sonar-reasoning-pro を使用）

ClaudeはPerplexity検索ツールを自動的に使用して関連情報を検索し、返します。サーバーはクエリの意図に基づいて最適なモデルを自動的に選択します。

何らかの理由で検索ツールを使用しないことにした場合は、プロンプトの前に「Web を検索」を追加して強制的に検索を実行できます。

インテリジェントなモデル選択

サーバーはクエリに基づいて最も適切な Perplexity モデルを自動的に選択します。

• 「深い研究」「包括的」「詳細」などの研究志向の用語を使用して、ソナーディープリサーチをトリガーします。

• 「解決する」「理解する」「複雑な問題」などの推論用語を使用して、sonar-reasoning-pro をトリガーします。

• 「クイック」「簡潔」「基本」などの簡単な言葉を使って軽量ソナーモデルを起動します

• バランスの取れたパフォーマンスのために、一般的な検索用語はデフォルトで sonar-pro に設定されます。

各検索応答には、使用されたモデルとその理由に関する情報が含まれます。

ドメインフィルタリング

このサーバーは、検索エクスペリエンスをカスタマイズするためのドメインフィルタリングをサポートしています。以下のコマンドを使用して、特定のドメインを許可またはブロックできます。

• 許可されたドメインを追加する: 「domain_filter ツールを使用して wikipedia.org を許可する」

• ブロックされたドメインを追加する：「domain_filter ツールを使用して pinterest.com をブロックする」

• 現在のフィルターを表示: 「list_filters ツールを使用する」(ドメインと最新フィルターを表示)

• すべてのフィルターをクリア: 「clear_filters ツールを使用する」(ドメインと最新フィルターの両方をクリア)

注：Perplexity APIは最大3つのドメインをサポートし、許可されたドメインが優先されます。ドメインフィルタリングには、この機能をサポートするPerplexity API層が必要です。

使用フローの例:

1. 「domain_filter ツールを使用して wikipedia.org を許可してください」

2. 「ドメインフィルターツールを使用してarxiv.orgを許可する」

3. 「list_filtersツールを使用する」（設定を確認するため）

4. 「量子コンピューティングの進歩を検索」 (検索結果では wikipedia.org と arxiv.org が優先されます)

最新フィルタリング

新しさフィルターを使用して、検索結果を特定の時間枠に制限することができます。

• 最新フィルターの設定：「filter=hour で recency_filter ツールを使用する」（オプション：時間、日、週、月）

• 最新フィルターを無効にする: 「filter=none で recency_filter ツールを使用する」

これは、現在の出来事や最新ニュースなど、時間に敏感なクエリに特に役立ちます。

モデル選択制御

自動モデル選択はほとんどの場合にうまく機能しますが、どのモデルが使用されるかを手動で制御することもできます。

• モデル情報の表示：「model_info ツールを使用する」

• 特定のモデルを設定する:「model=sonar-deep-research で model_info ツールを使用する」

• 自動選択に戻す: モデルをデフォルトモデルに戻します

使用例:

1. 「model_infoツールを使用する」（利用可能なモデルと現在のステータスを確認する）

2. 「model_info ツールを model=sonar-reasoning-pro とともに使用する」（推論モデルの使用を強制する）

3. 「ピタゴラスの定理の数学的証明を探す」（sonar-reasoning-pro を使用します）

4. 「model_infoツールでmodel=sonar-proを使用する」（自動選択に戻る）

発達

サーバーを変更するには:

1. src/index.tsを編集する

2. npm run buildでリビルドする

3. 変更をロードするにはClaudeを再起動してください

ライセンス

マサチューセッツ工科大学