「Couchbase」MCPサーバーは何をする？

Couchbase MCPサーバーは、Model Context Protocol（MCP）の実装であり、大規模言語モデル（LLM）やAIアシスタントがCouchbaseクラスタに保存されたデータへ直接アクセスできるようにします。ミドルウェアとして動作し、Couchbaseデータベース操作をAI駆動の開発ワークフローにシームレスに統合できます。コレクション構造の取得、IDによるドキュメントの取得・アップサート・削除、SQL++クエリの実行などをサポートします。LLMをライブのCouchbaseデータに接続することで、開発者はデータベース管理の自動化、生産性向上、複雑なデータ操作の自然言語化が可能になります。サーバーは読み取り専用または読み書きモードで設定でき、Claude Desktop、Cursor、Windsurfなど様々なMCPクライアントに対応しています。

プロンプト一覧

リポジトリにはプロンプトテンプレート情報はありません。

リソース一覧

リポジトリファイルやREADMEに明示的なリソース定義は記載されていません。

ツール一覧

• 全スコープ・コレクションの一覧取得: 指定したCouchbaseバケットの構成情報（メタデータ）を取得します。
• コレクション構造の取得: 指定コレクションの構造（スキーマ）情報を取得します。
• ID指定でドキュメント取得: スコープ・コレクション・IDを指定してドキュメントを取得します。
• ID指定でドキュメントをアップサート: 指定スコープ・コレクション内にドキュメントを新規挿入または更新します。
• ID指定でドキュメントを削除: 指定スコープ・コレクションからドキュメントを削除します。
• SQL++クエリの実行: 指定スコープで読み取り専用（またはオプションで書き込み可）のSQL++クエリを実行します。データ変更クエリは安全のためデフォルト無効です。

このMCPサーバーのユースケース

• データベース管理: AIインターフェースから直接ドキュメントの追加・更新・削除など一般的なDB操作を自動化し、手作業を削減。
• データ探索: 開発者やAIエージェントがデータ構造・コレクション・ドキュメント内容を迅速に探索し、分析やデバッグに活用。
• インタラクティブクエリ: 自然言語クエリをSQL++に変換しCouchbaseで実行、非専門家でもデータ取得が容易に。
• 自動レポート生成: AI主導のワークフローでクエリ・集計し、動的なレポートを自動生成。
• 開発ワークフローへのシームレス統合: Claude、Cursor、WindsurfなどのツールでCouchbaseデータアクセスを統合し、文脈認識したコーディングやドキュメント作成作業を効率化。

セットアップ方法

Windsurf

1. 前提条件：Python 3.10以上とuvがインストールされていること、Couchbaseクラスタへのアクセス権。
2. リポジトリをクローン：

   git clone https://github.com/Couchbase-Ecosystem/mcp-server-couchbase.git
   

3. Windsurf MCPクライアント設定を編集し、Couchbase MCPサーバーを追加：

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Windsurfを再起動して反映。
5. テストクエリで接続を確認。

Claude

1. 前提条件：Python 3.10+、uv、Couchbaseクラスタへのアクセス、Claude Desktopのインストール。
2. Couchbase MCPサーバーレポジトリをクローン。
3. 設定ファイルの場所：
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. 上記のサーバー設定をmcpServersセクションに追加。
5. Claude Desktopを再起動。
6. ClaudeのインターフェースからCouchbaseデータにクエリしてテスト。

Cursor

1. Python 3.10+、uv、Couchbaseクラスタへのアクセスを確認。
2. リポジトリをクローンし、必要なら依存パッケージをインストール。
3. Cursorの設定にCouchbase MCPサーバーを追加：

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Cursorを再起動。
5. データベース操作で動作確認。

Cline

1. 必要条件：Python 3.10+、uv、Couchbaseクラスタ。
2. リポジトリをローカルにクローン。
3. ClineのMCP設定に以下を追加：

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. 設定を保存してClineを再起動。
5. DBアクションを実行しセットアップを確認。

APIキーの安全管理:
全ての機密値（例：CB_PASSWORD）は設定のenvセクション内で環境変数として保存します。
例：

"env": {
  "CB_CONNECTION_STRING": "couchbases://connection-string",
  "CB_USERNAME": "username",
  "CB_PASSWORD": "password",
  "CB_BUCKET_NAME": "bucket_name"
}

フロー内でのMCPの使い方

FlowHuntでMCPを利用する

FlowHuntワークフローにMCPサーバーを統合するには、まずMCPコンポーネントをフローに追加し、AIエージェントに接続します。

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションで、下記のJSON形式でMCPサーバー情報を入力します。

{ “couchbase”: { “transport”: “streamable_http”, “url”: “https://yourmcpserver.example/pathtothemcp/url" } }

設定後、AIエージェントはこのMCPをツールとして利用でき、全機能にアクセス可能になります。“couchbase"部分は実際のMCPサーバー名に、URLもご自身のMCPサーバーURLに置き換えてください。

概要

上表から、Couchbase MCPサーバーはセットアップとツール公開に関しては十分にドキュメント化されていますが、プロンプトテンプレート・リソース定義・サンプリング/rootsサポートの明示的な記載がありません。データベース用途には明確に有用ですが、よりMCPネイティブな機能が強化されると更に良くなります。一般的なLLM・開発者用途として6/10と評価します。

MCPスコア