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

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

利用可能なツール

perplexity_search

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

perplexity_ask

sonar-proモデルを使用した、リアルタイムウェブ検索対応の汎用会話型AI。簡単な質問や日常的な検索に最適です。

perplexity_research

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

perplexity_reason

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

設定

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構造を使用します:

{
  "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をサポートしています。

HTTPサーバーのデプロイ

クラウドや共有環境へのデプロイには、サーバーをHTTPモードで実行します。

環境変数

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 / Initializeエラー: 一部の厳格なMCPクライアントは、npxがインストールメッセージをstdoutに書き込むために失敗することがあります。この出力を抑制するには、npx -yの代わりにnpx -yqを使用してください。

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