LLM 向け Couchbase MCP サーバー

🗄️ LLM 向け Couchbase MCP サーバー

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

🚀 クイックスタート

前提条件
- Node.js 16以上
- Capella上で稼働中のCouchbaseインスタンス
- クロードデスクトップアプリケーション
インストール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

クロードデスクトップ統合この構成を 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>"
      }
    }
  }
}

接続を確認する
- Claudeデスクトップを再起動します
- Couchbase MCPサーバーツールが会話で利用できるようになります。

📝 利用可能なツール

基本操作

query : N1QLクエリを実行する
listBuckets : 利用可能なバケットを一覧表示する

スコープ管理

createScope : バケットに新しいスコープを作成する
deleteScope : 既存のスコープを削除する
listScopes : バケット内のすべてのスコープを一覧表示する

コレクション管理

createCollection : スコープ内に新しいコレクションを作成する
dropCollection : スコープからコレクションを削除する

ドキュメント操作

createDocument : 新しいドキュメントを作成する
getDocument : IDでドキュメントを取得する
updateDocument : 既存のドキュメントを更新する
deleteDocument : IDでドキュメントを削除する
bulkCreateDocuments : 複数のドキュメントを一度に作成する

インデックス管理

createIndex : 指定されたフィールドに新しいインデックスを作成する
createPrimaryIndex : コレクションにプライマリインデックスを作成する
listIndexes : バケット内のすべてのインデックスを一覧表示する
dropIndex : 既存のインデックスを削除する

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

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

機密性の高い認証情報には常に環境変数を使用する
本番環境での使用にはリバースプロキシの背後でサーバーを実行することを検討してください
必要に応じて適切なアクセス制御と認証を実装する

📚 例

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

すべてのバケットを一覧表示します。
Could you show me all available buckets in the database?
スコープとコレクションを作成します。
Create a new scope called "users" and a collection called "profiles" in it
クエリドキュメント:
Find all users who signed up in the last 30 days
ドキュメントを作成します。
Create a new user document with name "John Doe" and email "john@example.com"

🤝 貢献

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

大規模な言語モデルが自然言語を介して Couchbase データベースと直接対話できるようにし、バケットのクエリ、CRUD 操作の実行、N1QL クエリの実行などの操作をサポートするモデルコンテキストプロトコルサーバー。

Related MCP Servers

ClickHouse MCP Server
ThomAub
-
security
A
license
-
quality
A Model Context Protocol server that enables Large Language Models to seamlessly interact with ClickHouse databases, supporting resource listing, schema retrieval, and query execution.
Last updated -
1
Python
MIT License
Astra DB MCP Serverofficial
datastax
A
security
A
license
A
quality
A Model Context Protocol server that allows Large Language Models to interact with Astra DB databases, providing tools for managing collections and records through natural language commands.
Last updated -
10
115
12
TypeScript
Apache 2.0
Superset MCP Server
LiusCraft
A
security
F
license
A
quality
A Model Context Protocol server that enables large language models to interact with Apache Superset databases through REST API, supporting database queries, table lookups, field information retrieval, and SQL execution.
Last updated -
4
3
TypeScript
MCP TapData Serverofficial
tapdata
-
security
F
license
-
quality
A Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.
Last updated -

View all related MCP servers

Couchbase MCP Server for LLMs