MCP Cassandra Server

🚀 Cassandra MCP サーバー

このモデルコンテキストプロトコル（MCP）サーバーは、Apache Cassandra データベースと Claude Desktop を統合し、自然言語での対話を通じてデータベース操作を実現します。

🚀 クイックスタート

1. NPX を使用して Cassandra MCP サーバーを実行する

まず、パッケージを 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  # オプション  
export CASSANDRA_USERNAME=your_username  # デフォルトは "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
    }
  ]
}

✨ 主な機能

このモデルコンテキストプロトコル（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：既存のデータを更新します。

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

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

   • 指定された条件に基づいてレコードを削除します。
   • 単純および複雑な条件の削除操作をサポートします。

6. 使用例

   • 「users」テーブルのすべてのユーザーを表示する：「users」テーブルのすべてのユーザーを表示
   • 新しいユーザーを挿入する：ユーザー名が John Doe、メールアドレスが john@example.com の新しいユーザーを挿入
   • ユーザー情報を更新する：ユーザー John Doe のメールアドレスを newjohn@example.com に更新
   • 特定のユーザーを削除する：ユーザー名が John Doe のユーザーを削除

🔧 その他の注意事項

• Cassandra サービスが実行されており、ネットワークからアクセス可能であることを確認してください。
• 環境変数が正しく設定されていることを検証してください。特に、コンタクトポイント (CASSANDRA_CONTACT_POINTS) とローカルデータセンター (CASSANDRA_LOCAL_DC) を確認してください。
• 指定されていない場合、デフォルトのユーザー名は cassandra で、パスワードは空または設定に応じたものになります。

以上の手順に従うことで、Cassandra データベースを Claude Desktop に簡単に統合し、自然言語での対話を利用して効率的なデータ操作を行うことができます。