Perplexity Ask MCP Server

Perplexity API Platform MCP サーバー

     

Perplexity API Platform の公式 MCP サーバー実装です。Agent API と Search API を通じて、AI アシスタントにリアルタイムのウェブ検索、推論、リサーチ機能を提供します。

リモート MCP サーバー

リモート MCP サーバーは Perplexity がホストしており、始めるのに最も簡単な方法です。同じツールを利用でき、インストールや更新は不要です。このページ上部の Cursor と VS Code のボタンを使えば、ワンクリックで接続できます。お使いの MCP クライアントがまだリモートサーバーに対応していない場合は、以下のローカルサーバーのセットアップに進んでください。Perplexity API キーを使って、Streamable HTTP 経由で接続します。

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 キーを取得する

1. API Portal から Perplexity API キーを取得します
2. 以下の設定で your_key_here を API キーに置き換えます
3. （任意）タイムアウトを設定します：PERPLEXITY_TIMEOUT_MS=600000（デフォルト：5 分）
4. （任意）カスタムベース URL を設定します：PERPLEXITY_BASE_URL=https://your-custom-url.com（デフォルト：https://api.perplexity.ai）
5. （任意）ログレベルを設定します：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 に対応しています。

メモ

サーバーは次の順序でプロキシ設定を確認します：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 移行ガイドには、名前付きサイズに相当するものはありません。明示的に指定した各予算は、対応する従来のデフォルト値を上書きします。

メモ

プリセットは、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、ストリーミング可能な HTTP、インメモリ）にマウントします。

トラブルシューティング

• API キーの問題：PERPLEXITY_API_KEY が正しく設定されていることを確認してください
• 接続エラー：インターネット接続と API キーの有効性を確認してください
• ツールが見つからない場合：パッケージがインストールされており、コマンドのパスが正しいことを確認してください
• タイムアウトエラー：非常に長い調査クエリの場合は、PERPLEXITY_TIMEOUT_MS により大きな値を設定してください
• プロキシの問題：PERPLEXITY_PROXY または HTTPS_PROXY の設定を確認し、ファイアウォールで api.perplexity.ai がブロックされていないことを確認してください。
• EOF／初期化エラー：一部の厳格な MCP クライアントでは、npx がインストールメッセージを標準出力に書き込むため、エラーが発生します。この出力を抑制するには、npx -y の代わりに npx -yq を使用してください。

サポートについては、community.perplexity.ai にアクセスするか、問題を報告してください。

---