MCP Cassandra Server

🚀 Cassandra MCP 服務器

此模型上下文協議（MCP）服務器能夠將 Apache Cassandra 數據庫與 Claude Desktop 集成，藉助自然語言交互的方式實現數據庫操作。

🚀 快速開始

使用 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"  

添加到 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 的用戶

💻 使用示例

基礎用法

# 使用 NPX 運行 Cassandra MCP 服務器
npx @sahil1115/mcp-cassandra-server

高級用法

# 添加到 Claude Desktop 配置
{
  "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 服務已運行且網絡可達。
• 驗證環境變量是否正確設置，特別是聯繫點 (CASSANDRA_CONTACT_POINTS) 和本地數據中心 (CASSANDRA_LOCAL_DC)。
• 如果未指定，默認用戶名為 cassandra，密碼為空或根據您的配置。

通過以上步驟，您可以輕鬆將 Cassandra 數據庫集成到 Claude Desktop，並利用自然語言交互進行高效的數據操作。