Perplexity Insight MCP サーバー

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

特徴

• Perplexity AI APIとのシームレスな統合

• さまざまな Perplexity モデルのサポート (sonar-reasoning、sonar-pro、sonar-deep-research)

• カスタマイズ可能なシステムプロンプトとユーザークエリ

• 適切なエラー処理と応答フォーマット

• レート制限保護

• Windsurf IDEとの簡単な統合

Related MCP server: Perplexity MCP Server

要件

• Node.js 18歳以上

• Perplexity APIキー

インストール

npm install

環境変数

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

PERPLEXITY_API_KEY=your_api_key_here

使用法

サーバーを実行します。

npm start

APIツール

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

1. perplexity_ask - Perplexity AIに直接質問を送信

2. 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
}

ウィンドサーフィン統合

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

1. サーバーを構築します。

   npm run build

2. Windsurfを開き、設定に移動します

3. 「AI設定」または「モデルコンテキストプロトコル」セクションを見つけます

4. 次の詳細で新しい MCP サーバーを追加します。

   • 名前: Perplexity Insight

   • タイプ: ローカルプロセス

   • コマンド: Node.js実行ファイルへのパス

   • 引数: コンパイルされたindex.jsファイルへのパス

   • 作業ディレクトリ: プロジェクトディレクトリへのパス

   • 環境変数: PERPLEXITY_API_KEY=your_api_key_hereを必ず含めてください

5. サーバーを有効にし、必要に応じて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 サーバーで問題が発生した場合:

1. APIキーが有効であり、 .envファイルに正しく設定されていることを確認してください。

2. 応答形式がMCP仕様と一致していることを確認する

3. サーバーログでエラーメッセージを探します

4. WindsurfがMCPサーバーを使用するように適切に設定されていることを確認します

ライセンス

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