Perplexity MCP Server

公式

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

GitHub
2.3k

ドキュメント

Perplexity API Platform MCP Server

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

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

利用可能なツール

perplexity_search

Perplexity Search APIを使用した直接的なWeb検索。メタデータ付きのランク付けされた検索結果を返し、最新情報の検索に最適です。

perplexity_ask

sonar-proモデルを使用した、リアルタイムWeb検索機能付きの汎用対話AI。簡単な質問や日常的な検索に最適です。

perplexity_research

sonar-deep-researchモデルを使用した、深く包括的なリサーチ。徹底的な分析や詳細なレポートに最適です。

perplexity_reason

sonar-reasoning-proモデルを使用した、高度な推論と問題解決。複雑な分析タスクに最適です。

[!TIP] perplexity_reason と perplexity_research のオプションパラメータとして利用可能: strip_thinking

true に設定すると、レスポンスから <think>...</think> タグが削除され、コンテキストトークンを節約できます。デフォルト: false

設定

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

Cursor, Claude Desktop, Kiro, Windsurf, VS Code

ほとんどのクライアントは、クライアント設定で同じ 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 でアクセス可能になります。

トラブルシューティング

  • 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 にアクセスするか、Issueを作成してください。