Perplexity Sonar MCP

🚀 Perplexity Sonar MCP サーバー

Perplexity の Sonar モデルを実装した強力な MCP サーバーです。Claude Desktop やその他の MCP クライアントをサポートします。従来の MCP サーバーとは異なり、この実装では、ネットワーク検索機能を備えた Perplexity の高度な AI モデルへのアクセスが可能で、Claude が会話中にリアルタイムでネットワーク検索を実行し、最新の情報を提供できるようになります。

🚀 クイックスタート

このサーバーは、Claude Desktop やその他の MCP クライアントに対して、Perplexity の高度な AI モデルを提供します。ネットワーク検索機能を通じて、会話中に最新の情報を取得できます。

✨ 主な機能

• リアルタイムネットワーク検索：会話中に最新の情報を取得できます。
• 複数のモデル選択：必要に応じて適切な Sonar モデルを選ぶことができます。
  • sonar：バランスの取れた汎用モデル
  • sonar-pro：強化された機能を持ち、複雑なタスクに適しています。
  • sonar-reasoning：論理的な推論と分析に特化しています。
  • sonar-deep-research：詳細な引用付きの深入りした調査に最適です。
• 豊富なパラメータオプション：多数のパラメータでクエリを微調整できます。
  • 検索ドメインと時効性の制御
  • 応答形式の調整（Markdown/JSON）
  • 温度とトークン生成制限の設定
  • 関連する質問と画像の取得
• シームレスな統合：Claude Desktop やその他のツールと完全に互換性があります。

📦 インストール

インストール要件

1. オペレーティングシステム：Windows、macOS または Linux
2. Node.js バージョン：>=14.x.x
3. ネットワーク接続：データを取得するためにインターネットにアクセスする必要があります。

インストール手順

npm パッケージマネージャーを使用したインストール

npm install -g perlexity-sonar-mcp-server

Claude Desktop での使用

1. ターミナルまたはコマンドプロンプトを開きます。
2. サーバーを起動します。

   mcp-server start --port 3000
   

3. Claude Desktop の設定で、MCP サーバーのアドレスを http://localhost:3000 に設定します。

独立した実行モード

1. リポジトリをクローンします。

   git clone https://github.com/felores/perplexity-sonar-mcp.git
   cd perplexity-sonar-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーを起動します。

   npm start
   

💻 使用例

基本的な使用法

const perplexityMcp = new PerplexitySonarMCP();
const result = await perplexityMcp.search("AI の現状");

高度な使用法

const options: SearchOptions = {
  model: "sonar-deep-research",
  domain: ["arxiv.org", "nature.com"],
  searchRecency: "week"
};
const result = await perplexityMcp.search("大言語モデルの最新研究", options);

📚 ドキュメント

API リファレンス

インターフェース定義

interface PerplexitySonarMCP {
  search(query: string, options?: SearchOptions): Promise<SearchResult>;
}

検索オプション

type SearchOptions = {
  model?: "sonar" | "sonar-pro" | "sonar-reasoning" | "sonar-deep-research";
  domain?: string[];
  searchRecency?: "hour" | "day" | "week" | "month";
  maxResults?: number;
};

検索結果

type SearchResult = {
  results: ResultItem[];
  error?: string;
};

type ResultItem = {
  title: string;
  url: string;
  content: string;
  source: string;
  date: string;
};

🔧 技術詳細

開発手順

1. リポジトリをクローンします。

   git clone https://github.com/felores/perplexity-sonar-mcp.git
   cd perplexity-sonar-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. 開発モードで起動します。

   npm run dev
   

トラブルシューティング

1. API キーが正しいことを確認します。
2. Node.js のバージョンが要件を満たしていることを確認します。
3. Claude Desktop のログを確認します。
   • macOS: ~/Library/Logs/Claude/mcp.log
   • Windows: %APPDATA%\Claude\logs\mcp.log
4. 問題を切り分けるために、独立したモードで実行してみます。

📄 ライセンス

MIT