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サーバーが正常に統合されているはずです。

✨ 主な機能

以下の操作が可能です。

• list buckets：すべてのバケットをリストする
• describe bucket <name>：指定されたバケットの詳細を説明する
• create bucket <name> <type>：新しいバケットを作成する
• delete bucket <name>：指定されたバケットを削除する
• query <sql-query>：N1QLクエリを実行する

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

• 環境変数：パスワードなどの機密情報は、ハードコードするのではなく、環境変数を通じて提供する必要があります。
• リバースプロキシ：本番環境では、HTTPSリクエストを処理し、MCPサーバーへのアクセスを制限するために、リバースプロキシ（例：Nginx）を使用することをお勧めします。

💻 使用例

以下はいくつかの使用例です。

# すべてのバケットをリストする
list buckets

# 指定されたバケットの詳細を説明する
describe bucket my_bucket

# 新しいバケットを作成する
create bucket my_new_bucket Couchbase

# バケットを削除する
delete bucket old_bucket

# N1QLクエリを実行する
query SELECT * FROM my_bucket LIMIT 10

🤝 コントリビューション

コミュニティからのコントリビューションを歓迎します！問題を見つけた場合や改善提案がある場合は、GitHubリポジトリMCP-Server-Couchbaseをご覧ください。

皆さんの支援と協力に感謝します。一緒にこのプロジェクトをさらに良いものにしましょう！