mcp-cassandra-server

Cassandra MCP Server
この Model Context Protocol（MCP）サーバーは、Apache Cassandra データベースを Claude Desktop と統合し、自然言語でのやり取りを通じてデータベース操作を可能にします。

1. NPX を使用した Cassandra MCP Server の実行 まず、パッケージを npm に公開します（またはローカルで使用します）。

npx @sahil1115/mcp-cassandra-server

必須の環境変数（実行前に設定するか、.env ファイルに設定してください）：

export CASSANDRA_PASSWORD=your_password
export CASSANDRA_CONTACT_POINTS=host1,host2
export CASSANDRA_LOCAL_DC=your_datacenter
export CASSANDRA_KEYSPACE=your_keyspace  # optional
export CASSANDRA_USERNAME=your_username  # defaults to "cassandra"

2. Claude Desktop の設定への追加

Claude Desktop の設定ファイル（通常は claude-desktop.config.json）に、次の内容を追加します。

{
  "tools": [
    {
      "name": "mcp-cassandra-server",
      "command": "npx @sahil1115/mcp-cassandra-server",
      "env": {
        "CASSANDRA_PASSWORD": "your_password",
        "CASSANDRA_CONTACT_POINTS": "host1,host2",
        "CASSANDRA_LOCAL_DC": "your_datacenter",
        "CASSANDRA_KEYSPACE": "your_keyspace"
      },
      "stdio": true
    }
  ]
}

Cassandra MCP Server の機能 この Model Context Protocol（MCP）サーバーは、Apache Cassandra データベースと Claude Desktop を統合し、自然言語でのやり取りを通じてデータベース操作を可能にします。

ツール

1. execute_query：Cassandra データベースで CQL クエリを実行します

• あらゆる種類の CQL クエリ（SELECT、INSERT、UPDATE、DELETE）に対応
• クエリ結果を構造化された形式で返します
• インジェクション攻撃を防ぐため、パラメーターを渡すことができます

2. create_table：Cassandra データベースに新しいテーブルを作成します

• 列名とデータ型を指定してテーブルスキーマを定義します
• 主キー（単純キー、またはパーティションキーとクラスタリングキーを使用した複合キー）を設定します
• テーブルが存在しない場合は自動的に作成します

3. insert_data：Cassandra テーブルにデータを挿入します

• 既存のテーブルに新しいレコードを追加します
• すべての Cassandra データ型に対応
• JavaScript の型を Cassandra の型に自動変換します

4. update_data：Cassandra テーブルの既存データを更新します

• 指定した条件に基づいてレコードを変更します
• 1 回の操作で複数の列を更新します
• 安全性を確保するため、パラメーター化クエリを使用します

5. delete_data：Cassandra テーブルからデータを削除します

• 指定した条件に基づいてレコードを削除します
• 1 回の操作で 1 件または複数のレコードを削除します

6. list_tables：現在のキースペース内にあるすべてのテーブルを一覧表示します

• 利用可能なテーブルの概要を確認できます
• スキーマをすばやく調べられます

使用例

自然言語を使って Cassandra データベースを操作する方法の例を紹介します。

データのクエリ

次のような質問をできます。

• 「'users' テーブルのすべてのユーザーを表示して」
• 「顧客 'ABC123' の最新の注文を 10 件見つけて」
• 「'customers' テーブルのユーザーの平均年齢は？」

テーブルの作成

次のような指示を出せます。

• 「id、name、price、category の列を持つ新しい 'products' テーブルを作成して」
• 「email を主キーにした users テーブルを作成して」
• 「device_id と timestamp を主キーにした、温度計測値用の時系列テーブルを作成して」

データの挿入

次のようなデータ挿入を依頼できます。

• 「Sarah Smith という名前、メールアドレス [email protected]、年齢 32 の新しいユーザーを追加して」
• 「ID 12345、名前 'Wireless Earbuds'、価格 $99.99 の商品を挿入して」
• 「現在の時刻に、デバイス ABC の温度 72.5°F の計測値を追加して」

データの更新

次のような更新を依頼できます。

• 「[email protected] のユーザーの電話番号を 555-123-4567 に更新して」
• 「商品 12345 の価格を $89.99 に変更して」
• 「顧客 ABC123 のすべての注文を 'shipped' に変更して」

データの削除

次のような削除を依頼できます。

• 「メールアドレス [email protected] のユーザーを削除して」
• 「'discontinued' カテゴリーのすべての商品を削除して」
• 「2023 年 1 月 1 日より前の温度計測値を削除して」

複雑な操作

自然言語を使って、より複雑な操作を行うこともできます。

• 「先月、ニューヨークの顧客が注文したすべての商品を見つけて」
• 「今四半期のカテゴリー別売上合計を計算して」
• 「ログイン回数に基づいて、最もアクティブなユーザーを上位 5 人まで一覧表示して」