🗄️ LLM 向け Couchbase MCP サーバー

LLMがCapellaクラスタ上のCouchbaseデータベースと直接やり取りできるようにするモデルコンテキストプロトコル（MCP）サーバー。バケットのクエリ、CRUD操作の実行、N1QLクエリの実行、そして自然言語によるシームレスなデータ管理が可能です。

🚀 クイックスタート

1. 前提条件

   • Node.js 16以上

   • Capella上で稼働中のCouchbaseインスタンス

   • クロードデスクトップアプリケーション

2. インストール

   Couchbase MCP Server は、次の 2 つの方法でインストールできます。

オプション 1: NPX を使用する (推奨)

最も早く始める方法は、NPX を使用することです。

npx -y @couchbasedatabase/couchbase-mcp

オプション2: 手動インストール

プロジェクトを手動で複製して実行する場合:

# Clone the repository
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# Install dependencies
npm install

# Build the project
npm run build

3. クロードデスクトップ統合

   この構成を Claude Desktop 構成ファイルに追加します。

   Windows : %APPDATA%/Claude/claude_desktop_config.json
   MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json

オプション1: パッケージインストール

{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": ["-y", "@couchbasedatabase/couchbase-mcp"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

オプション2: 手動インストール

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE CONNECTION STRING>",
        "COUCHBASE_BUCKET": "<BUCKET NAME>",
        "COUCHBASE_USERNAME": "<COUCHBASE USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE PASSWORD>"
      }
    }
  }
}

4. 接続を確認する

   • Claudeデスクトップを再起動します

   • Couchbase MCPサーバーツールが会話で利用できるようになります。

Related MCP server: MCP TapData Server

📝 利用可能なツール

基本操作

• query : N1QLクエリを実行する

• listBuckets : 利用可能なバケットを一覧表示する

スコープ管理

• createScope : バケットに新しいスコープを作成する

• deleteScope : 既存のスコープを削除する

• listScopes : バケット内のすべてのスコープを一覧表示する

コレクション管理

• createCollection : スコープ内に新しいコレクションを作成する

• dropCollection : スコープからコレクションを削除する

ドキュメント操作

• createDocument : 新しいドキュメントを作成する

• getDocument : IDでドキュメントを取得する

• updateDocument : 既存のドキュメントを更新する

• deleteDocument : IDでドキュメントを削除する

• bulkCreateDocuments : 複数のドキュメントを一度に作成する

インデックス管理

• createIndex : 指定されたフィールドに新しいインデックスを作成する

• createPrimaryIndex : コレクションにプライマリインデックスを作成する

• listIndexes : バケット内のすべてのインデックスを一覧表示する

• dropIndex : 既存のインデックスを削除する

各ツールは、特定のデータ コンテナーをターゲットとするオプションのcollectionパラメーターとscopeパラメーターをサポートしています。

🔒 セキュリティに関する考慮事項

• 機密性の高い認証情報には常に環境変数を使用する

• 本番環境での使用にはリバースプロキシの背後でサーバーを実行することを検討してください

• 必要に応じて適切なアクセス制御と認証を実装する

📚 例

MCP サーバーを使用した Claude とのやり取りの例を次に示します。

1. すべてのバケットを一覧表示します。

   Could you show me all available buckets in the database?

2. スコープとコレクションを作成します。

   Create a new scope called "users" and a collection called "profiles" in it

3. クエリドキュメント:

   Find all users who signed up in the last 30 days

4. ドキュメントを作成します。

   Create a new user document with name "John Doe" and email "john@example.com"

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。