Perplexity Web Search MCP Server

Perplexity Web Search MCP サーバー

Perplexity API を使用したウェブ検索機能を提供するシンプルな MCP（Model Context Protocol）サーバーです。このサーバーを使うと、Claude やその他の MCP 対応 AI アシスタントがウェブを検索し、最新情報を取得できます。

機能

• Perplexity の強力な検索機能でウェブを検索します
• 出典と引用を含む包括的な検索結果を取得します
• 期間（day、week、month、year）で結果を絞り込みます
• すぐに使えるウェブ検索用プロンプトテンプレートが含まれています
• 環境変数または .env ファイルから API キーを読み込めます

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   pip install -e .
   

   または

   uv pip install -e .
   

設定

Perplexity API キーを設定した PERPLEXITY_API_KEY 環境変数を指定できます：

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\ Support/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. 相反する情報に言及する
6. リンク付きで出典を引用する

ライセンス

MIT