Perplexity

公式

PerplexityのSonar APIに接続し、会話型AIでリアルタイムのウェブ全体のリサーチを可能にするMCPサーバー。

GitHub
2.4k

Perplexity MCPで何ができますか？

  • リアルタイムWeb検索 — perplexity_search を使用して最新情報をリクエスト。オプションで期間フィルターやドメイン制限も可能。
  • ライブソースによるクイックQ&A — perplexity_ask を使用して、リアルタイムWeb検索に基づく会話形式の回答を得る。
  • 詳細なリサーチレポート — perplexity_research を通じて、多段階の徹底的な分析をリクエスト。長時間のタスクでは進捗がストリーミング表示される。
  • 複雑な推論タスク — perplexity_reason を活用して、高度な問題解決や分析作業を行う。
  • カスタムデプロイオプション — サーバーをローカル、Docker、または自己ホスト型HTTPサービスとして実行可能。プロキシやセキュリティ設定も構成できる。

ドキュメント

Perplexity API プラットフォーム MCP サーバー

Install in Cursor   Install in VS Code   Add to Kiro   npm version

Perplexity API プラットフォーム向けの公式 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 ポータルから 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

その他の MCP クライアント

ほとんどのクライアントは、クライアント設定で同じ mcpServers ラッパーを使用して手動で設定できます (Cursor に示されているとおり)。クライアントのスキーマが異なる場合は、正確なラッパー形式についてドキュメントを確認してください。

手動セットアップの場合、これらのクライアントはすべて同じ mcpServers 構造を使用します:

クライアント設定ファイル
Cursor~/.cursor/mcp.json
Claude Desktopclaude_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_KEYPerplexity API キー必須
PERPLEXITY_BASE_URLAPI リクエスト用のカスタムベース URLhttps://api.perplexity.ai
PORTHTTP サーバーポート8080
BIND_ADDRESSバインドするネットワークインターフェース。デフォルトはループバック。すべてのインターフェースで公開するには 0.0.0.0 に設定。127.0.0.1
ALLOWED_ORIGINSCORS オリジン (カンマ区切り)。デフォルトは空 (クロスオリジンのブラウザリクエストなし)。明示的な許可リスト (例: 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

Perplexity Search API を使用した直接ウェブ検索。メタデータ付きのランク付けされた検索結果を返し、最新情報の検索に最適です。期間フィルター (search_recency_filter) とドメイン制限 (search_domain_filter) をサポートしています。

perplexity_ask

リアルタイムのウェブ検索を備えた汎用の会話型 AI。Agent API の fast プリセットを利用しています。簡単な質問や日常的な検索に最適です。

perplexity_research

Agent API の high プリセットを利用した、深く包括的なリサーチ。徹底的な分析と詳細なレポートに最適です。実行には数分かかる場合があります。サーバーは実行をストリーミングし、要求するクライアントに進捗を報告します。

perplexity_reason

Agent API の medium プリセットを利用した高度な推論と問題解決。複雑な分析タスクに最適です。

[!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 -y の代わりに npx -yq を使用してください。

サポートについては、community.perplexity.ai または問題を報告してください。