Perplexity Ask MCP Server
公式MCPエコシステム内でウェブ検索を可能にするPerplexity API用のコネクタです。
Perplexity Ask MCPで何ができますか?
- リアルタイムWeb検索 —
perplexity_searchを使用して、鮮度フィルター、ドメイン制限、または高速モード付きの最新のランク付けされた検索結果を要求します。 - 対話型Q&A —
perplexity_askツールを使用して、日常的な質問に対する迅速でWebに基づいた回答を取得します。 - 詳細な調査レポート —
perplexity_researchを使用して、徹底的な調査のための包括的で多段階の分析を要求します。 - 高度な推論 —
perplexity_reasonを使用して、段階的な問題解決を通じて複雑な分析問題に取り組みます。 - カスタマイズ可能な検索深度 — askおよびreasonツールの
max_tokensとmax_tokens_per_pageの予算を設定して、取得する検索コンテキストを制御します。
ドキュメント
Perplexity API プラットフォーム MCP サーバー
Perplexity API プラットフォーム向けの公式 MCP サーバー実装です。Agent API と Search API を通じて、AI アシスタントにリアルタイムのウェブ検索、推論、リサーチ機能を提供します。
リモート MCP サーバー
リモート MCP サーバーは Perplexity がホストしており、最も簡単に始められる方法です。同じツールを利用でき、インストールや更新は不要です。このページ上部の Cursor および VS Code ボタンをクリックするだけで接続できます。お使いの MCP クライアントがリモートサーバーに対応していない場合は、以下のローカルサーバーのセットアップに進んでください。Streamable HTTP 経由で Perplexity API キーを使用して接続します:
https://api.perplexity.ai/mcp
Claude Code の場合:
claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"
手動での Cursor/VS Code 設定、Anthropic API からの利用、その他のクライアントのセットアップについては、MCP 統合ドキュメントを参照してください。
ローカル MCP サーバー
API キーの取得
- API ポータルから Perplexity API キーを取得します
- 以下の設定の
your_key_hereを API キーに置き換えます - (任意)タイムアウトを設定:
PERPLEXITY_TIMEOUT_MS=600000(デフォルト:5分) - (任意)カスタムベース URL を設定:
PERPLEXITY_BASE_URL=https://your-custom-url.com(デフォルト:https://api.perplexity.ai) - (任意)ログレベルを設定:
PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR(デフォルト:ERROR)
Claude Code
claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
またはプラグインでインストール:
export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity
Codex
codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server
エージェントプラグイン
このリポジトリは Agent Plugin としてパッケージ化されているため、標準に対応したクライアントはこのリポジトリから直接インストールできます。Agent Plugins 形式はシークレットを保持しないため、クライアントのプラグインまたは MCP 設定を通じて PERPLEXITY_API_KEY 環境変数を設定してください。
その他の MCP クライアント
ほとんどのクライアントは、クライアント設定で同じ mcpServers ラッパーを使用して手動で設定できます(Cursor で示されている通り)。クライアントのスキーマが異なる場合は、正確なラッパー形式についてドキュメントを確認してください。
手動セットアップの場合、これらのクライアントはすべて同じ mcpServers 構造を使用します:
| クライアント | 設定ファイル |
|---|---|
| Cursor | ~/.cursor/mcp.json |
| Claude Desktop | claude_desktop_config.json |
| Kiro | .kiro/settings/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code | .vscode/mcp.json |
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": ["-y", "@perplexity-ai/mcp-server"],
"env": {
"PERPLEXITY_API_KEY": "your_key_here"
}
}
}
}
プロキシ設定(企業ネットワーク向け)
職場でこのサーバーを実行している場合(特に会社のファイアウォールやプロキシの背後)、ネットワークのプロキシを通じてインターネットトラフィックを送信する方法をプログラムに指示する必要があるかもしれません。次の手順に従ってください:
1. プロキシ情報を取得
- IT 部門に HTTPS プロキシのアドレスとポートを問い合わせてください。
- ユーザー名とパスワードが必要な場合もあります。
2. プロキシ環境変数を設定
Perplexity MCP で最も簡単で信頼性の高い方法は、PERPLEXITY_PROXY を使用することです。例:
export PERPLEXITY_PROXY=https://your-proxy-host:8080
プロキシにユーザー名とパスワードが必要な場合は、次を使用します:
export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080
3. 代替:標準環境変数
標準の変数を使用したい場合は、HTTPS_PROXY と HTTP_PROXY に対応しています。
[!NOTE] サーバーは次の順序でプロキシ設定を確認します:
PERPLEXITY_PROXY→HTTPS_PROXY→HTTP_PROXY。いずれも設定されていない場合は、インターネットに直接接続します。 URL にはhttps://を含める必要があります。一般的なポートは8080、3128、80です。
セルフホスト HTTP モード
クラウドや共有デプロイメントの場合は、HTTP モードでサーバーを実行します。
環境変数
| 変数 | 説明 | デフォルト |
|---|---|---|
PERPLEXITY_API_KEY | Perplexity API キー | 必須 |
PERPLEXITY_BASE_URL | API リクエスト用のカスタムベース URL | https://api.perplexity.ai |
PORT | HTTP サーバーポート | 8080 |
BIND_ADDRESS | バインドするネットワークインターフェース。デフォルトはループバック。すべてのインターフェースで公開するには 0.0.0.0 に設定。 | 127.0.0.1 |
ALLOWED_ORIGINS | CORS オリジン(カンマ区切り)。デフォルトは空(クロスオリジンのブラウザリクエストなし)。明示的な許可リスト(例:https://app.example.com)または任意のオリジンを許可する * に設定。 | (空) |
ALLOWED_HOSTS | 受け入れる追加の Host ヘッダー値(カンマ区切り)。PORT のループバックホストは常に許可されます。0.0.0.0 にバインドする場合は公開ホスト名を追加してください。 | (ループバックのみ) |
Docker
docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server
Node.js
export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http
サーバーは http://localhost:8080/mcp でアクセスできます。
利用可能なツール
perplexity_search
検索結果には、利用可能な場合、公開日と最終更新日が含まれます。欠落または null の日付は、フォーマットされた出力から省略されます。
Perplexity Search API を使用した直接ウェブ検索。メタデータ付きのランク付けされた検索結果を返し、最新情報の検索に最適です。期間フィルター(search_recency_filter)、ドメイン制限(search_domain_filter)、および低レイテンシーと低コストのための Fast Search(search_type: "fast")に対応しています。
perplexity_ask
Agent API の fast プリセットを利用した、リアルタイムウェブ検索付きの汎用会話型 AI。簡単な質問や日常的な検索に最適です。
perplexity_research
Agent API の high プリセットを利用した、深く包括的なリサーチ。徹底的な分析と詳細なレポートに最適です。実行には数分かかる場合があります。サーバーは実行をストリーミングし、要求したクライアントに進捗を報告します。
perplexity_reason
Agent API の medium プリセットを利用した、高度な推論と問題解決。複雑な分析タスクに最適です。
perplexity_ask と perplexity_reason は、任意の正の整数の max_tokens(合計検索コンテキスト、最大 120,000)と max_tokens_per_page(結果ページあたりのコンテキスト、最大 20,000)を受け入れます。これらの Agent API バジェットは、取得する検索コンテンツを制御し、生成される回答の長さは制御しません。省略した場合、プリセットの検索設定が有効のままになります。
レガシーの search_context_size 引数は引き続き受け入れられますが、Agent API に送信されるのではなく、ローカルで明示的なバジェットに変換されます:
| レガシーサイズ | 合計トークン | ページあたりのトークン |
|---|---|---|
low | 2000 | 512 |
medium | 4000 | 1024 |
high | 8000 | 2048 |
この互換性ポリシーは Sonar の名前付きサイズと完全に同等ではありません。Agent API 移行ガイドには名前付きサイズの同等物はありません。各明示的なバジェットは、対応するレガシーデフォルトを上書きします。
[!NOTE] プリセットは、Perplexity が時間をかけて調整を続ける管理された設定(モデル、検索設定、ステップバジェット)です。プリセットガイドを参照してください。このサーバーの以前のバージョンでは、レガシーの
sonar-pro、sonar-reasoning-pro、sonar-deep-researchモデルを呼び出し、strip_thinking/reasoning_effortパラメータを受け入れていました。これらのパラメータはツールスキーマの一部ではなくなり、送信された場合は無視されます。Agent API は<think>タグを生成しません。
ライブラリとしての使用
このパッケージは、独自の Node プロセスに埋め込むためのサーバーファクトリもエクスポートします:
import { createPerplexityServer } from "@perplexity-ai/mcp-server";
// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");
// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
apiKey: () => currentRequestApiKey,
});
返されたサーバーを任意の MCP トランスポート(stdio、streamable HTTP、インメモリ)にマウントします。
トラブルシューティング
- API キーの問題:
PERPLEXITY_API_KEYが正しく設定されていることを確認してください - 接続エラー:インターネット接続と API キーの有効性を確認してください
- ツールが見つからない:パッケージがインストールされ、コマンドパスが正しいことを確認してください
- タイムアウトエラー:非常に長いリサーチクエリの場合は、
PERPLEXITY_TIMEOUT_MSをより高い値に設定してください - プロキシの問題:
PERPLEXITY_PROXYまたはHTTPS_PROXYの設定を確認し、api.perplexity.aiがファイアウォールでブロックされていないことを確認してください。 - EOF / 初期化エラー:一部の厳格な MCP クライアントは、
npxがインストールメッセージを stdout に書き込むために失敗します。この出力を抑制するには、npx -yqの代わりにnpx -yを使用してください。
サポートについては、community.perplexity.ai または問題を報告してください。