Perplexity MCP Server Gfh

🚀 モデルコンテキストプロトコルに基づくPerplexity統合プロジェクト

このプロジェクトは、モデルコンテキストプロトコル（Model Context Protocol）に基づいて構築されており、Perplexity との統合を実現することを目的としています。Perplexityの強力な検索エンジンと大規模言語モデル（LLM）を活用することで、ユーザーにより高度で効率的な検索強化型質問応答機能を提供します。

🚀 クイックスタート

このプロジェクトを使用するには、以下の手順に従ってください。

1. 依存関係のインストール：

npm install mcp-ts-template @perplexity/api

2. 設定の初期化： config.ts ファイルを作成し、以下の内容を追加します。

export const config = {
  api_key: 'your-perplexity-api-key',
  search_context_size: 5,
  // その他のカスタム設定
};

3. サービスの起動： 以下のコマンドを実行します。

npm run dev

✨ 主な機能

• 検索強化型質問応答：ユーザーは自然言語で質問を行い、Perplexityの検索結果に基づく回答を得ることができます。
• 多様なパラメータサポート：検索動作をカスタマイズできます。例えば、関連する質問の返却、検索結果の時間範囲のフィルタリング、ドメインのフィルタリングなどが可能です。
• 拡張性：フレームワークの設計が柔軟であり、新しいツールや機能モジュールを容易に追加することができます。

📦 インストール

このプロジェクトを使用するには、以下の手順でインストールしてください。

1. 依存関係のインストール：

npm install mcp-ts-template @perplexity/api

2. 設定の初期化： config.ts ファイルを作成し、以下の内容を追加します。

export const config = {
  api_key: 'your-perplexity-api-key',
  search_context_size: 5,
  // その他のカスタム設定
};

3. サービスの起動：

npm run dev

💻 使用例

基本的な使用法

const result = await perplexity_search({
  query: "什么是人工智能？",
  return_related_questions: true,
  search_recency_filter: 'week',
  search_domain_filter: ['example.com']
});

高度な使用法

// 高度な検索条件を設定した例
const result = await perplexity_search({
  query: "高度な検索条件の例",
  return_related_questions: true,
  search_recency_filter: 'month',
  search_domain_filter: ['example1.com', 'example2.com']
});

📚 ドキュメント

perplexity_search ツール

このツールは、Perplexity APIを使用して検索強化型クエリを実行し、ウェブ検索結果に基づく質問に回答するために使用されます。

入力パラメータ

開発ガイド

プロジェクト構造

• src/: 核心業務ロジックとモジュールが含まれています。
• config/: アプリケーションの設定ファイルが保存されています。
• types/: カスタムタイプとインターフェースが定義されています。

迅速な開発フロー

1. 新しい機能モジュールの作成：
   • src/components ディレクトリに新しいコンポーネントファイルを作成します。
   • 関連する業務ロジックを実装し、プロジェクトの規範に準拠するようにします。
2. 新しい機能のテスト：
   • ユニットテストフレームワーク（例: Jest）を使用してテストケースを作成し、実行します。
   • すべての新しい機能がテストに合格することを確認します。
3. デプロイとリリース：
   • ローカルで npm run build を実行してビルドファイルを生成します。
   • コードをバージョン管理システムにコミットし、セマンティックバージョニングに従ってリリースします。

プロジェクトのメンテナンス

• ログ記録：重要な業務ロジックに適切なログ出力を追加し、デバッグとモニタリングを容易にします。
• エラー処理：すべてのAPI呼び出しと外部サービスのやり取りに対して、完全なエラー捕捉と回復メカニズムを提供します。
• パフォーマンス最適化：定期的にコードをレビューし、潜在的なパフォーマンスのボトルネックを最適化します。

🔧 技術詳細

プロジェクトの全体アーキテクチャは、明確な階層化原則に従っています。

                    ┌──────────────┐
                    │    Client     │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │   Handler    │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │  Server      │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │ Services     │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │   Config     │
                    └──────┬───────┘
                           │
                    ┌──────▼───────┐
                    │  Database    │
                    └──────────────┘

📄 ライセンス

本プロジェクトは MIT License に従っており、自由な使用、修正、配布が許可されていますが、著作権表示を保持する必要があります。