Couchbase MCP サーバー
モデルコンテキストプロトコル（MCP）は、大規模言語モデル（LLM）と外部システム間の相互作用を処理するためのプロトコルです。このリポジトリは、Couchbase Node.js SDKを使用してCouchbase MCPサーバーを実装し、MCPクライアント（Claude Desktopなど）がCouchbase Capellaクラスタ上で自然言語クエリを実行できるようにします。
このサーバーでは次のようなコマンドを使用できます:
Show me the results of SELECT * FROM my_bucket LIMIT 10Execute this query: SELECT name, age FROM users WHERE active = trueGet me the latest 5 documents from my_bucketSummarize the latest 5 orders from the orders bucket for me
例
以下のスクリーンショットは、Claude DesktopクライアントでMCPサーバーが動作している様子を示しています。ユーザーは平易な英語で一般的なリクエストを発行し、MCPサーバーはそれをSQL++クエリに変換してCouchbase Capellaクラスターに対して実行します。そして、その結果はユーザーに読みやすい形式で返されます。
Related MCP server: Couchbase MCP Server for LLMs
設定
リポジトリをクローンし、依存関係をインストールします。
ルート ディレクトリに
.envファイルを作成し、Couchbase 接続文字列、ユーザー名、パスワードを追加します。
必要な環境変数については、 .env.sampleファイルを参照してください。
プロジェクトをビルドします。
Stdio トランスポートを使用してサーバーを実行します。
MCPサーバーはStdioServerTransportを使用するため、標準入出力を介して通信します。MCPクライアント（例：Claude Desktop）がローカルMCPサーバーを使用するように設定されていることを確認してください。ClaudeDesktopのドキュメントに従って、MCPクライアントをローカルサーバーに接続するための設定を行ってください。
特徴
Couchbase クエリツール
ツール名:
query-couchbase説明: Couchbase Capella クラスターで SQL++ クエリ ステートメントを実行します。
使用方法: 呼び出されると、サーバーは Couchbase Node.js SDK を使用して、提供された SQL++ クエリを実行し、結果を返します。
現像
プロジェクトをローカルで作業するには:
依存関係をインストールします:
MCP クライアントを使用してサーバーをテストします。
接続するように構成された MCP クライアント (例: Claude Desktop) を起動し、サンプル クエリを使用してツールを呼び出します。
デバッグ
stdout MCPプロトコルのJSONのみが含まれるように、すべてのログメッセージはstderrに送信されます。詳細な接続メッセージとエラーメッセージについては、ログをご確認ください。
貢献
貢献を歓迎します！プルリクエストを送信したり、提案をIssueで公開したりしてお気軽にご連絡ください。変更を加える際は、プロジェクトのコードスタイルに従ってください。
ライセンス
このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。
