MCP Cassandra Server

该项目是一个Cassandra数据库的MCP服务，通过自然语言交互实现数据库操作，包括查询、创建表、增删改数据等功能，并与Claude Desktop集成。

数据库开发者工具 #数据库交互 #自然语言 #Cassandra #MCP服务 .TypeScript

评分 : 2分

下载量 : 8.1K

更新时间 : 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，并利用自然语言交互进行高效的数据操作。