mcpField
C
Couchbase

Couchbase

ローカル
github.com/hummusonrailsデータベース183 週間前に更新
リポジトリ

Couchbase について

Couchbaseは、自然言語のリクエストでCouchbase Capellaクラスターを検索できるMCPサーバーです。Couchbase Node.js SDKでSQL++クエリを実行し、結果を返します。

主な機能

  1. 01SQL++クエリの実行
  2. 02Couchbase Capellaクラスターへの接続
  3. 03MCPクライアントへのクエリ結果の返却

活用シーン

  1. 01リクエストに合うドキュメントの取得
  2. 02条件を指定したフィールド検索
  3. 03バケット内の最新ドキュメントの取得

MCP 対応

Couchbase CapellaクラスターでSQL++文を実行し、結果を返す`query-couchbase`ツールをMCPクライアントに提供します。

#couchbase#mcp-server#database-query

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "couchbase": {
      "command": "npx",
      "args": [
        "-y",
        "couchbase-mcp-server"
      ],
      "env": {
        "COUCHBASE_CONNECTION_STRING": "<COUCHBASE_CONNECTION_STRING>",
        "COUCHBASE_USERNAME": "<COUCHBASE_USERNAME>",
        "COUCHBASE_PASSWORD": "<COUCHBASE_PASSWORD>"
      }
    }
  }
}
起動コマンドnpx -y couchbase-mcp-server
設定が必要な環境変数
COUCHBASE_CONNECTION_STRING
COUCHBASE_USERNAME
COUCHBASE_PASSWORDシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmcouchbase-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Couchbase MCP サーバー

Model Context Protocol（MCP）はプロトコルです。大規模言語モデル（LLM）と外部システム間のやり取りを処理します。このリポジトリでは、Couchbase Node.js SDK を使用して Couchbase MCP サーバーを実装し、MCP クライアント（Claude Desktop など）が Couchbase Capella クラスターに自然言語でクエリを実行できるようにします。

このサーバーを使うと、次のような指示を実行できます。

  • Show me the results of SELECT * FROM my_bucket LIMIT 10
  • Execute this query: SELECT name, age FROM users WHERE active = true
  • Get me the latest 5 documents from my_bucket
  • Summarize the latest 5 orders from the orders bucket for me

例

次のスクリーンショットは、Claude Desktop クライアントで MCP サーバーが動作している様子を示しています。ユーザーが平易な英語で一般的なリクエストを送信すると、MCP サーバーがそれを SQL++ クエリに変換し、Couchbase Capella クラスターに対して実行します。その後、結果が読みやすい形式でユーザーに返されます。

Claude で MCP サーバーが動作している様子のスクリーンショット例

セットアップ

  1. リポジトリをクローンし、依存関係をインストールします。
git clone [email protected]:hummusonrails/couchbase-mcp-server.git
cd couchbase-mcp-server
npm install
  1. ルートディレクトリに .env ファイルを作成し、Couchbase の接続文字列、ユーザー名、パスワードを追加します。
COUCHBASE_CONNECTION_STRING=couchbases://your-cluster.cloud.couchbase.com
COUCHBASE_USERNAME=your_username
COUCHBASE_PASSWORD=your_password

必要な環境変数については、.env.sample ファイルを参照してください。

  1. プロジェクトをビルドします。
npm run build
  1. Stdio トランスポートを使用してサーバーを実行します。
npx couchbase-mcp-server

メモ

MCP サーバーは StdioServerTransport を使用するため、標準入力／標準出力を介して通信します。MCP クライアント（Claude Desktop など）がローカルの MCP サーバーを使用するように設定されていることを確認してください。 Claude Desktop のドキュメントに従って、ローカルサーバーに接続するよう MCP クライアントを設定してください。

機能

Couchbase クエリツール
  • ツール名: query-couchbase
  • 説明: Couchbase Capella クラスターで SQL++ クエリステートメントを実行します。
  • 使用方法: 呼び出されると、サーバーは Couchbase Node.js SDK を使用して指定された SQL++ クエリを実行し、結果を返します。

開発

ローカルでプロジェクトを開発するには、次の手順を実行します。

  1. 依存関係をインストールします。
npm install
npm run build
  1. MCP クライアントを使用してサーバーをテストします。

MCP クライアント（Claude Desktop など）を起動し、サンプルクエリを使ってツールを呼び出せるように接続設定を行います。

  1. デバッグ

すべてのログメッセージは stderr に送信されるため、stdout には MCP プロトコルの JSON のみが含まれます。詳細な接続情報やエラーメッセージについては、ログを確認してください。

コントリビューション

コントリビューションを歓迎します。プルリクエストを送信するか、提案を添えて issue を作成してください。変更を行う際は、プロジェクトのコードスタイルに従ってください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルを参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。