Perplexity Ask MCP Server

公式

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

GitHub
2.4k

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

  • リアルタイムでウェブ検索 — perplexity_search を使用して最新情報を取得。必要に応じて、直近の期間やドメインで絞り込みも可能です。
  • ライブ検索で素早く回答 — perplexity_ask を使用して、ウェブ検索結果に基づいた、会話形式の高速な回答を得られます。
  • 深いリサーチを実施 — perplexity_research を使用して、徹底的な多段階分析と詳細なレポートを依頼できます。
  • 複雑な推論タスクを解決 — perplexity_reason を使用して、高度なステップバイステップの推論で分析的な問題に取り組みます。

ドキュメント

Perplexity API Platform MCP Server

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

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

リモート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を使用した直接Web検索。ランク付けされた検索結果をメタデータ付きで返し、最新情報を見つけるのに最適です。最新性フィルター（search_recency_filter）とドメイン制限（search_domain_filter）をサポートします。

perplexity_ask

Agent APIのfastプリセットに支えられた、リアルタイムWeb検索機能付きの汎用会話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にアクセスするか、Issueを作成してください。