MCP Cassandra Server

該項目是一個Cassandra數據庫的MCP服務，通過自然語言交互實現數據庫操作，包括查詢、創建表、增刪改數據等功能，並與Claude Desktop集成。

數據庫開發者工具 #數據庫交互 #自然語言 #Cassandra #MCP服務 .TypeScript

評分 : 2分

下載量 : 7.4K

更新時間 : 2025-04-29

打開站點

什麼是Cassandra MCP Server?

這是一個連接Apache Cassandra數據庫和Claude Desktop的橋樑服務，允許用戶通過自然語言而非專業查詢語句來操作數據庫。它理解您的日常語言請求，自動轉換為數據庫操作。

如何使用Cassandra MCP Server?

只需在Claude Desktop中像平常一樣提問或給出指令，服務會自動處理背後的數據庫操作。例如說'顯示最近的用戶訂單'而不是寫CQL查詢。

適用場景

適合需要頻繁查詢Cassandra但不想記憶複雜語法的業務人員，或需要快速驗證數據的開發測試場景。

主要功能

智能查詢

支持SELECT等各類查詢，自動轉換自然語言為CQL語句

表結構管理

通過簡單指令創建/修改表結構，自動處理主鍵等複雜設置

數據操作

完整的增刪改查(CRUD)功能，支持批量操作

數據探索

快速查看數據庫中有哪些表和字段

安全防護

自動參數化查詢，防止SQL注入攻擊

優勢

無需學習複雜的CQL語法

減少簡單查詢的開發時間

降低非技術人員使用數據庫的門檻

自動優化查詢安全性

侷限性

複雜分析查詢仍需專業語法

性能調優需要直接訪問數據庫

部分高級Cassandra功能需要原生CQL

如何使用

安裝服務

通過npm安裝或直接使用npx運行

配置連接

設置Cassandra數據庫連接參數

集成到Claude

將服務添加到Claude Desktop配置文件中

使用案例

客戶數據查詢

市場團隊需要查找高價值客戶信息

產品庫存管理

倉庫管理員更新庫存信息

用戶行為分析

產品經理分析用戶活躍度

常見問題

需要提前瞭解Cassandra數據庫嗎？

支持哪些Cassandra數據類型？

如何確保查詢性能？

🚀 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 集成，通過自然語言交互實現數據庫操作。

工具

execute_query：在 Cassandra 數據庫上執行 CQL 查詢
- 支持所有類型的 CQL 查詢（SELECT、INSERT、UPDATE、DELETE）
- 以結構化格式返回查詢結果
- 可通過參數傳遞防止注入攻擊
create_table：創建新的 Cassandra 數據庫表
- 定義表的列名和數據類型
- 配置主鍵（簡單或複合主鍵，包括分區鍵和聚簇鍵）
- 如果表不存在自動創建
insert_data：向 Cassandra 表中插入數據
- 向現有表添加新記錄
- 支持所有 Cassandra 數據類型
- 自動將 JavaScript 類型轉換為 Cassandra 類型
update_data：更新現有數據中的數據
- 根據指定條件修改記錄
- 單次操作中可更新多個列
- 使用參數化查詢確保安全性
delete_data：從 Cassandra 表中刪除數據
- 根據指定條件刪除記錄
- 支持簡單和複雜條件的刪除操作
使用示例
- 顯示“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，並利用自然語言交互進行高效的數據操作。