mcp-cassandra-server

Cassandra MCP Server
这个模型上下文协议（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 功能 这个模型上下文协议（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 表中的现有数据

• 根据指定条件修改记录
• 在单次操作中更新多列
• 使用参数化查询以确保安全

5. delete_data：删除 Cassandra 表中的数据

• 根据指定条件删除记录
• 在单次操作中删除一条或多条记录

6. list_tables：列出当前键空间中的所有表

• 查看可用表的概览
• 快速发现表结构

使用示例

以下是使用自然语言与 Cassandra 数据库交互的示例：

查询数据

你可以提出以下问题：

• “显示 'users' 表中的所有用户”
• “查找客户 'ABC123' 最近的 10 笔订单”
• “'customers' 表中用户的平均年龄是多少？”

创建表

你可以提出以下指令：

• “创建一个新的 'products' 表，包含 id、name、price 和 category 列”
• “创建一个 users 表，并将 email 设为主键”
• “创建一个温度读数时序表，并将 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 位用户。”