Perplexity Web Search

🚀 パープレキシティ ネットワーク検索 MCP サーバー

このサーバーは、Perplexity API を利用したシンプルな MCP（モデルコンテキストプロトコル）サーバーで、Claude やその他の MCP 互換の AI アシスタントがネットワーク検索を行い、最新情報を取得できるようにします。

🚀 クイックスタート

このサーバーを使用することで、Claude や他の MCP 互換の AI アシスタントが Perplexity API を通じてネットワーク検索を行い、最新の情報を取得できます。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• Perplexity の強力な検索機能を使ったネットワーク検索
• 出典や引用を含む包括的な検索結果の取得
• 時間範囲（日、週、月、年）で結果をフィルタリング
• すぐに使えるネットワーク検索のプロンプトテンプレートの提供
• 環境変数または .env ファイルから API キーを読み込むサポート

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。以下のいずれかのコマンドを実行してください。

   pip install -e .
   

   または

   uv pip install -e .
   

📚 ドキュメント

設定

PERPLEXITY_API_KEY 環境変数を設定することで、Perplexity API キーを使用できます。

export PERPLEXITY_API_KEY="your-api-key-here"

または、プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記述します。

PERPLEXITY_API_KEY=your-api-key-here

参考として、.env.example ファイルが提供されています。

Perplexity API キーを取得するには、以下の手順に従ってください。

1. Perplexity API 設定にアクセスします。
2. アカウントがない場合は作成します。
3. API キーを生成します。

使用方法

サーバーの起動

python server.py

サーバー機能のテスト

完全な MCP サーバーを起動せずに、含まれているテストスクリプトを使用してサーバー機能をテストできます。

python test_server.py "your search query here" --recency month

--recency のオプションは、'day', 'week', 'month' (デフォルト), 'year' です。

Claude Desktop への統合

1. Claude Desktop の設定ファイルを編集します。
   • macOS の場合：~/Library/Application\ 支持/Claude/claude_desktop_config.json
   • Windows の場合：%APPDATA%/Claude/claude_desktop_config.json
2. 以下の設定を追加します。

   {
     "perplexity-mcp": {
       "env": {
         "PERPLEXITY_API_KEY": "your-api-key-here"
       },
       "command": "python",
       "args": [
         "/path/to/server.py"
       ]
     }
   }
   

3. Claude Desktop を再起動します。

サンプルプロンプト（Claude 用）

• “人工知能の最新ニュースに関するネットワーク情報を検索”
• “Perplexity を使って過去 1 週間の気候変動に関する情報を探す”
• “過去 1 か月の量子コンピューティングに関する最新の研究論文を検索”

API リファレンス

ツール：search_web(query: str, recency: str = "month") -> str

Perplexity API を使用してネットワークを検索し、結果を返します。

パラメータ：

• query：検索クエリ文字列
• recency：時間範囲で結果をフィルタリング - 'day', 'week', 'month' (デフォルト), または 'year'

戻り値： 以下を含む包括的なテキスト応答です。

1. 検索結果の詳細な要約
2. 重要な事実と情報
3. 検証用のソース URL
4. あれば、矛盾する情報

プロンプト：web_search_prompt(query: str, recency: str = "month") -> str

Perplexity を使用したネットワーク検索用のプロンプトテンプレートを作成します。

パラメータ：

• query：検索クエリ
• recency：時間範囲フィルタ - 'day', 'week', 'month' (デフォルト), または 'year'

戻り値： AI に指示するためのフォーマットされたプロンプト文字列です。

1. 指定されたクエリを検索する
2. 指定された時間範囲内の結果に焦点を当てる
3. 重要な発見を要約する
4. 情報の重要性を指摘する
5. 具体的な詳細を提供する