Perplexity Insight MCP サーバー

Perplexity AI API とインターフェイスするための MCP サーバー実装。標準化されたモデルコンテキストプロトコルを通じて高度な質問回答機能を提供します。

特徴

Perplexity AI APIとのシームレスな統合
さまざまな Perplexity モデルのサポート (sonar-reasoning、sonar-pro、sonar-deep-research)
カスタマイズ可能なシステムプロンプトとユーザークエリ
適切なエラー処理と応答フォーマット
レート制限保護
Windsurf IDEとの簡単な統合

要件

Node.js 18歳以上
Perplexity APIキー

インストール

npm install

環境変数

次の変数を含む.envファイルを作成します。

PERPLEXITY_API_KEY=your_api_key_here

使用法

サーバーを実行します。

npm start

APIツール

サーバーは次のツールを公開します。

perplexity_ask - Perplexity AIに直接質問を送信
perplexity_search - Perplexity AIで検索クエリを実行する

モデルの変更

どちらのツールも、次の Perplexity モデルをサポートしています。

sonar-reasoning (デフォルト) - Perplexity の推論重視のモデル。一般的な質問に最適
sonar-pro - プロフェッショナルユースケース向けに機能強化された拡張モデル
sonar-deep-research - 詳細な調査と複雑なクエリに特化しています

ツールを使用するときにモデルを指定するには、リクエストにmodelパラメータを含めます。

Ask Perplexity using sonar-deep-research: What are the latest advancements in quantum computing?

システムプロンプトと最大トークン数をカスタマイズすることもできます。

Search with Perplexity using sonar-pro with system prompt "You are a helpful research assistant" and max tokens 2000: Latest developments in renewable energy

ツール応答形式

サーバーは、ツール応答に関して MCP 仕様に従います。

{
  content: [
    {
      type: "text",
      text: "Response content from Perplexity AI"
    }
  ],
  isError: false // or true if an error occurred
}

ウィンドサーフィン統合

ウィンドサーフィンのセットアップ

サーバーを構築します。
npm run build
Windsurfを開き、設定に移動します
「AI設定」または「モデルコンテキストプロトコル」セクションを見つけます
次の詳細で新しい MCP サーバーを追加します。
- 名前: Perplexity Insight
- タイプ: ローカルプロセス
- コマンド: Node.js実行ファイルへのパス
- 引数: コンパイルされたindex.jsファイルへのパス
- 作業ディレクトリ: プロジェクトディレクトリへのパス
- 環境変数: PERPLEXITY_API_KEY=your_api_key_hereを必ず含めてください
サーバーを有効にし、必要に応じてWindsurfを再起動します。

構成例

mcp_config.jsonファイルの構成例を次に示します。

"perplexity-ask": {
  "command": "node",
  "args": [
    "/path/to/perplexity-insight-MCP/dist/index.js"
  ],
  "cwd": "/path/to/perplexity-insight-MCP",
  "env": {
    "PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

/path/to/perplexity-insight-MCP実際のインストールディレクトリへのパスに置き換え、実際の Perplexity API キーを使用します。

ウィンドサーフィンにおけるPerplexityの利用

AIアシスタントパネルを使用して、Perplexityに問い合わせる質問をします。
ウェブ検索の場合は、「検索」などの具体的な語句をクエリに含めます
モデルを変更するには、「モデルの変更」セクションに示されているように、クエリにモデル名を含めます。
Windsurfはクエリに基づいて適切なPerplexityツールを自動的に使用します

発達

地域開発の場合:

npm run dev

トラブルシューティング

MCP サーバーで問題が発生した場合:

APIキーが有効であり、 .envファイルに正しく設定されていることを確認してください。
応答形式がMCP仕様と一致していることを確認する
サーバーログでエラーメッセージを探します
WindsurfがMCPサーバーを使用するように適切に設定されていることを確認します

ライセンス

マサチューセッツ工科大学