MCP Server Couchbase

🚀 🗓️ Couchbase MCP サーバー for LLMs

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

🚀 クイックスタート

1. 前提条件

• Node.js 16以上
• 稼働中のCouchbaseインスタンス（Capella）
• Claude Desktopアプリケーション

2. インストール

Couchbase MCPサーバーには2種類のインストール方法があります。

方法1：NPXを使用する（推奨）

最速の方法はNPXを使ってインストールすることです。

npx -y @couchbasedatabase/couchbase-mcp

方法2：手動インストール

プロジェクトをクローンして実行する場合は、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/Aniket310101/MCP-Server-Couchbase.git
cd MCP-Server-Couchbase

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

3. Claude Desktopとの統合

以下の設定を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 接続文字列>",
        "COUCHBASE_BUCKET": "<バケット名>",
        "COUCHBASE_USERNAME": "<Couchbase ユーザー名>",
        "COUCHBASE_PASSWORD": "<Couchbase パスワード>"
      }
    }
  }
}

方法2：手動でインストールする

{
  "mcpServers": {
    "couchbase": {
      "command": "node",
      "args": ["path/to/MCP-Server-Couchbase/dist/index.js"],
      "env": {
        "COUCHBASE_URL": "<COUCHBASE 接続文字列>",
        "COUCHBASE_BUCKET": "<バケット名>",
        "COUCHBASE_USERNAME": "<Couchbase ユーザー名>",
        "COUCHBASE_PASSWORD": "<Couchbase パスワード>"
      }
    }
  }
}

4. 接続の検証

• Claude Desktopを再起動します。
• Couchbase MCPサーバーツールがダイアログで使用可能になります。

✨ 主な機能

• N1QLクエリの実行：言語指示によりデータベースをクエリし、操作することができます。
• バケットとデータの管理：バケットとその中のデータを作成、読み取り、更新、削除することができます。
• 接続パラメータの設定：Couchbaseサーバーへの接続を確立するために必要な環境変数を設定することができます。

⚠️ 注意事項

• すべての環境変数、特に認証情報が正しいことを確認してください。
• 本番環境で使用する前に、すべての機能をテストして正常に動作することを確認してください。

💻 使用例

基本的な使用法

バケットの作成

名前が "my_bucket" の新しいバケットを作成します。

ドキュメントの削除

バケット "my_bucket" 内のドキュメント "_user/123" を削除します。

データの更新

バケット "my_bucket" 内のキー "_product/456" の値を {"name": "New Product", "price": 99.99} に更新します。

以上の手順に従うことで、コードを書かずに複雑なデータ操作を行い、Couchbaseデータベースと簡単にやり取りすることができます。