perplexity-mcp-server

Perplexity Sonar APIを基盤とした、構造化された競合/市場インテリジェンスのモニタリングワークフロー用のMCPサーバー。

訂正(2026-08-26): このREADMEの以前のバージョンでは、ネイティブなPerplexity MCPコネクタはどこにも存在しないと主張していました。それは誤りでした — Perplexityは公式のMCPサーバーを公開しています(github.com/perplexityai/modelcontextprotocol)。これには、Perplexityがホストするリモートエンドポイントhttps://api.perplexity.ai/mcpも含まれており、セルフホスティングなしでクラウドスケジュールされたセッションから到達できます。ただ汎用的なアドホックのSonar検索が必要なだけなら、ここで何かを構築・実行する代わりに、そちらを登録してください。

公式サーバーが提供しないのは、構造化され、比較可能な週次モニタリング出力です。公式サーバーが公開しているのは汎用の検索/推論(Agent API、Search API)であり、固定セクションの企業ニュース要約やJSONスキーマで制約されたシグナルスイープではありません。それがこのサーバーが存在する実際の理由です — 2つのワークフローツールからなる薄く狭いレイヤーであり、Perplexity自身のMCPサーバーの代替品ではありません。

このサーバーを一度デプロイし(下記の「リモートデプロイメント」を参照)、PERPLEXITY_API_KEYをプラットフォームのシークレットとして設定すれば、あらゆるMCPクライアント — クラウドスケジュールされたCowork/Claudeセッションを含む — が、ローカルマシンやデバイスブリッジに一切触れることなく、HTTP経由で呼び出せます。Perplexityの公式サーバーと併用して登録してください。その代わりに登録するのではありません。

ツール

• perplexity_company_news — 構造化された企業ニュース要約(ガバナンス、経営陣、戦略的イベント、財務状況、人事異動)、固定セクション見出し、フリーテキストの日付範囲の代わりにlookback_daysを使用します。

• perplexity_market_signals — サーバーサイドのJSONスキーマに制約された、セクター全体のシグナルスイープ(M&A、資金調達、任命、再編)。そのため、結果は再パースが必要なマークダウンではなく、個別のシグナルの実際の配列になります。期間内に日付があり信頼できるものが見つからない場合は、エラーではなく空配列を返します — これは失敗ではなく、意味のある結果です。

両ツールはresponse_format: "markdown" | "json"をサポートし、引用/情報源を返します。汎用検索には、代わりにPerplexity公式のMCPサーバーを使用してください — 上記の訂正を参照。

Related MCP server: Stelar Signals MCP

セットアップ

npm install
cp .env.example .env   # then set PERPLEXITY_API_KEY
npm run build

ローカル利用(stdio) — クイックスタート、クラウドスケジュール問題は解決しない

テストや、自分のマシンで既に動いているワークフローに適しています。MCPクライアントの設定(例: Claude Desktopのclaude_desktop_config.json)に登録してください:

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-mcp-server/dist/index.js"],
      "env": { "PERPLEXITY_API_KEY": "pplx-..." }
    }
  }
}

これでは、そのマシンが起動している間だけ利用可能になります — キーを必要とするクラウドスケジュールタスクという当初の問題は解決できません。その場合は、下記のHTTPデプロイメントを使用してください。

リモートデプロイメント(streamable HTTP) — クラウドスケジュールタスクの実際の解決策

同じコードをTRANSPORT=httpで、Node対応の任意のホスト(小規模なVPS、Render、Railway、Fly.io、任意のクラウドプロバイダーのコンテナ)上で実行します。唯一の要件は、Node 18+、環境変数のシークレットを設定できること、そして公開HTTPS URLです。

PERPLEXITY_API_KEY=pplx-... TRANSPORT=http PORT=3000 npm start

サーバーが公開するもの:

• POST /mcp — MCPエンドポイント(streamable HTTP、ステートレスJSON — リクエストごとに新しいサーバー+トランスポートを生成するため、呼び出し間で情報が漏れることはなく、共有状態なしで水平スケールします)

• GET /health — ホスティングプラットフォームのヘルスプローブ用の単純な死活確認

HTTPSの背後にデプロイしたら(https://your-host/mcp)、そのURLをワークスペース内のリモートMCPコネクタとして登録し、Perplexity依存のスケジュールタスクが直接到達できるようにします。キーはサーバーサイドに置きます — これはPappersが既に使用している運用モデルと同じです(ネイティブコネクタ、認証情報パスにローカルシークレットなし)。

このビルドで検証されたこと

• npm run buildはクリーンにコンパイルされます(厳格なTypeScript、anyなし)。

• 両方のトランスポート(stdioとHTTP)がクラッシュせずに起動します。

• GET /healthが正しく応答します。

• 完全なMCPハンドシェイク(initialize、tools/list)は、正しいJSONスキーマ、説明、注釈とともに両ツールを返します。

• 無効なAPIキーを使ったtools/callは、クリーンで、対処可能なisError: trueの結果(Perplexityダッシュボードを指し示す401ガイダンス)を返します — サーバーはクラッシュせず、その後も応答し続けます。

まだ検証されていないこと

ビルド環境では実際のPERPLEXITY_API_KEYを利用できなかったため、実際のSonar呼び出しの成功 — 実際の回答内容、実際の引用、market_signalsのJSONスキーマ制約付きレスポンスが実際に有効なJSONとしてパースされること — はエンドツーエンドで確認されていません。本番のモニタリングルーチンでこれに依存する前に、実際のキーを使って2つのツールをそれぞれ一度実行し(この確認にはローカルのstdioで十分です)、出力が上記で説明した形状と一致することを確認してください。

コストに関する注意

perplexity_company_newsとperplexity_market_signalsはどちらも、デフォルトでsonar-proモデルを使用します(sonarよりも深い検索、より多くの情報源、呼び出しごとのコストが高い)。これは、モニタリングのユースケースがレイテンシー/コストよりも完全性と引用品質を優先するためです — このサーバーの両ツールにおける意図的なデフォルトであり、2026-08-26に確認済みです。1回限りのクエリでより安価なモデルを選択するためのperplexity_searchツールはここにはありません。その場合は、Perplexity公式のMCPサーバーを使用してください(このファイル冒頭の訂正を参照)。数十社にわたる週次ルーチンの規模でこれを実行する前に、Perplexityの現在のモデル別料金を確認してください — フル実行では、およそ50〜90社に加えて1回のマーケットシグナルスイープを処理するため、sonar-proとsonarの限界費用の差は急速に累積します。