local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports configuration through environment variables in a .env file, enabling secure storage of Couchbase credentials.
Enables interaction with Couchbase databases, allowing querying buckets, performing CRUD operations on documents, managing scopes and collections, executing N1QL queries, and handling index operations.
Uses Git for version control and installation through the git clone command.

🗄️ 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

F

license - not found

-

quality - not tested

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

Couchbase MCP Server for LLMs

Integrations

🗄️ LLM 向け Couchbase MCP サーバー

🚀 クイックスタート

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

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

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

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

📝 利用可能なツール

基本操作

スコープ管理

コレクション管理

ドキュメント操作

インデックス管理

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

📚 例

🤝 貢献

Appeared in Searches