Perplexity Ask MCP Server

公式

MCPエコシステム内でウェブ検索を可能にするPerplexity API用のコネクタです。

GitHub
2.5k
このMCPを試すスポンサー

Perplexity Ask MCPで何ができますか？

  • リアルタイムWeb検索 — perplexity_searchを使用して、最新のランキング付き検索結果を、鮮度やドメインフィルター付きでアシスタントに取得させます。
  • 対話型Q&A — perplexity_askを使用して、ライブWeb検索に基づく日常的な質問への迅速な回答を得ます。
  • 詳細な調査レポート — perplexity_researchを使用して、徹底的なトピックについて、数分かけて包括的な分析をリクエストします。
  • 高度な推論 — perplexity_reasonを通じて、ステップバイステップの問題解決で複雑な分析問題に取り組みます。

ドキュメント

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 設定を通じて PERPLEXITY_API_KEY 環境変数を設定してください。

その他の 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)、および低レイテンシーと低コストのための Fast Search (search_type: "fast") をサポートしています。

perplexity_ask

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

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 にアクセスするか、問題を報告してください。