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

MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License
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 -
Couchbase MCP Server
hummusonrails
-
security
A
license
-
quality
A server that enables natural language interactions with Couchbase databases through the Model Context Protocol, allowing users to perform SQL++ queries on Couchbase Capella clusters using conversational commands.
Last updated -
1
JavaScript
MIT License
Firestore Advanced MCP
diez7lm
-
security
A
license
-
quality
A Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.
Last updated -
2
4
JavaScript
MIT License

View all related MCP servers

Couchbase MCP Server for LLMs