Star Wars Planet Data (Couchbase)

🚀 《星球大战》惑星の意味検索用Couchbaseモデルコンテキストプロトコルサーバー

このプロジェクトは、Couchbaseのベクトル検索機能を使用して実装されたモデルコンテキストプロトコル（MCP）サーバーを展示しており、《星球大战》の惑星に対する意味検索機能を提供します。

🚀 クイックスタート

このプロジェクトでは、Couchbaseのベクトル検索機能を利用したモデルコンテキストプロトコル（MCP）サーバーを構築し、《星球大战》の惑星に関する意味検索を可能にしています。

✨ 主な機能

• モデルコンテキストプロトコル（MCP）を通じて、AIモデルが《星球大战》の惑星の詳細情報を取得できます。
• ベクトル埋め込みに基づいて、類似した惑星を検索できます。

🔧 技術詳細

モデルコンテキストプロトコルの統合

このサーバーは、以下の2つの主要なMCPツールを実装しています。

{
tools: [
{
name: "fetch_planet_name",
description: "名前で《星球大战》の惑星を取得する",
inputSchema: // ... 惑星名のスキーマ
},
{
name: "find_planets_which_are_similar",
description: "指定された名前と類似した惑星を検索する",
inputSchema: // ... 惑星名のスキーマ
}
]
}

これらのツールは、MCPをサポートするAIモデルによって発見され、呼び出されることができます。

Couchbaseのベクトル検索

この実装では、Couchbaseのベクトル検索機能を使用して類似した惑星を検索します。

1. Couchbase内の各惑星ドキュメントには、惑星の特徴を表すベクトルを含むembeddingフィールドがあります。
2. 類似した惑星を検索する際には、以下の手順を実行します。
   • 元の惑星の埋め込みを取得します。
   • Couchbaseのベクトル検索を使用して、類似した埋め込みを持つ惑星を検索します。
   • 最も類似した5つの惑星を返します。

主要機能

• 効率的なベクトル検索：Couchbaseのベクトルインデックスを利用して、高速な類似性検索を実現します。
• タイムアウト保護：検索およびドキュメント取得操作にタイムアウトを実装しています。
• 接続管理：Couchbaseの接続を適切に管理し、クリーンアップします。
• エラー処理：包括的なエラー処理とデバッグサポートを提供します。
• 型安全：完全なTypeScript実装で、正しい型定義があります。

📦 インストール

前提条件

• Node.js
• ベクトル検索機能を備えたCouchbaseサーバー
• 環境変数：

  COUCHBASE_URL=
  COUCHBASE_USERNAME=
  COUCHBASE_PASSWORD=
  COUCHBASE_BUCKET=
  COUCHBASE_SCOPE=
  COUCHBASE_COLLECTION=
  

データ構造

各惑星ドキュメントは、以下の構造に従う必要があります。

interface StarWarsCharacter {
name: string;
rotation_period: string;
orbital_period: string;
diameter: string;
climate: string;
gravity: string;
terrain: string;
surface_water: string;
population: string;
residents: string[];
films: string[];
created: string;
edited: string;
url: string;
embedding?: number[]; // 類似性検索用のベクトル埋め込み
}

ベクトル検索インデックス

Couchbase内に、embeddingフィールドを参照するvector-search-indexという名前のベクトル検索インデックスを作成します。

💻 使用例

基本的な使用法

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

   npm start
   

2. サーバーは、stdin/stdoutを通じてMCPリクエストを待機します。
3. AIモデルは、以下の例のようなクエリを使用してサーバーとやり取りできます。

   // 惑星の詳細情報を取得する
   {
     "name": "fetch_planet_name",
     "arguments": {
       "name": "Tatooine"
     }
   }
   
   // 類似した惑星を検索する
   {
     "name": "find_planets_which_are_similar",
     "arguments": {
       "name": "Tatooine"
     }
   }