Astra智能数据库管理工具

@datastax/astra-db-mcp
0 Stars 350 次浏览 datastax 更新于 2026-08-23

一个模型上下文协议服务器,允许大型语言模型与Astra DB数据库交互,通过自然语言命令提供管理集合和记录的工具。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "astra-db-mcp": {
      "args": [
        "-y",
        "@datastax/astra-db-mcp"
      ],
      "command": "npx",
      "env": {
        "ASTRA_DB_API_ENDPOINT": "your_astra_db_endpoint",
        "ASTRA_DB_APPLICATION_TOKEN": "your_astra_db_token"
      }
    }
  }
}

该服务需要配置环境变量:ASTRA_DB_API_ENDPOINT、ASTRA_DB_APPLICATION_TOKEN

可用工具 (10 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

GetCollections

Get all collections in the Astra DB database

该工具无需必填参数,直接调用即可

CreateCollection 3 个参数 需填 1 项

Create a new collection in the database

必填参数:collectionName

UpdateCollection 2 个参数 需填 2 项

Update an existing collection in the database

必填参数:collectionName、newName

DeleteCollection 1 个参数 需填 1 项

Delete a collection from the database

必填参数:collectionName

ListRecords 2 个参数 需填 1 项

List records from a collection in the database

必填参数:collectionName

GetRecord 2 个参数 需填 2 项

Get a specific record from a collection by ID

必填参数:collectionName、recordId

CreateRecord 2 个参数 需填 2 项

Create a new record in a collection

必填参数:collectionName、record

UpdateRecord 3 个参数 需填 3 项

Update an existing record in a collection

必填参数:collectionName、recordId、record

DeleteRecord 2 个参数 需填 2 项

Delete a record from a collection

必填参数:collectionName、recordId

FindRecord 4 个参数 需填 3 项

Find records in a collection by field value

必填参数:collectionName、field、value

服务介绍

Astra DB MCP 服务器

一个用于与 Astra DB 交互的模型上下文协议 (MCP) 服务器。MCP 通过允许大型语言模型 (LLMs) 作为代理与外部系统交互来扩展其功能。

前提条件

你需要有一个正在运行的 Astra DB 数据库。如果你还没有,可以在这里创建一个免费数据库。从那里,你可以获得两样你需要的东西:

  1. 一个 Astra DB 应用令牌
  2. Astra DB API 端点

要了解如何获取这些,请阅读入门文档

添加到 MCP 客户端

以下是如何将此服务器添加到你的 MCP 客户端的方法。

Claude 桌面版

Claude 桌面版

要将此添加到 Claude 桌面版,请转到偏好设置 -> 开发者 -> 编辑配置,并将此 JSON 片段添加到 claude_desktop_config.json 中:

{
  "mcpServers": {
    "astra-db-mcp": {
      "command": "npx",
      "args": ["-y", "@datastax/astra-db-mcp"],
      "env": {
        "ASTRA_DB_APPLICATION_TOKEN": "your_astra_db_token",
        "ASTRA_DB_API_ENDPOINT": "your_astra_db_endpoint"
      }
    }
  }
}

Windows PowerShell 用户:
npx 是一个批处理命令,因此请按如下方式修改 JSON:

  "command": "cmd",
  "args": ["/k", "npx", "-y", "@datastax/astra-db-mcp"],

Cursor

Cursor

要将此添加到 Cursor,请转到设置 -> Cursor 设置 -> MCP

在那里,你可以通过点击“+ 添加新的 MCP 服务器”按钮来添加服务器,这将带你进入一个 mcp.json 文件。

提示:有一个 ~/.cursor/mcp.json 表示你的全局 MCP 设置,还有一个特定于项目的 .cursor/mcp.json 文件。
你可能希望将此 MCP 服务器安装到项目特定文件中。

按照 Claude 桌面版说明中的指示添加相同的 JSON。

或者,你可能会看到一个向导,在其中可以输入以下值(对于基于 Unix 的系统):

  • 名称:任意名称
  • 类型:命令
  • 命令:
env ASTRA_DB_APPLICATION_TOKEN=your_astra_db_token ASTRA_DB_API_ENDPOINT=your_astra_db_endpoint npx -y @datastax/astra-db-mcp

一旦添加完成,你的编辑器将完全连接到你的 Astra DB 数据库。

可用工具

该服务器提供了以下工具用于与 Astra DB 交互:

  • GetCollections: 获取数据库中的所有集合
  • CreateCollection: 在数据库中创建一个新的集合
  • UpdateCollection: 更新数据库中已存在的集合
  • DeleteCollection: 从数据库中删除一个集合
  • ListRecords: 列出数据库中某个集合的记录
  • GetRecord: 根据ID从集合中获取特定记录
  • CreateRecord: 在集合中创建一条新记录
  • UpdateRecord: 更新集合中的现有记录
  • DeleteRecord: 从集合中删除一条记录
  • FindRecord: 根据字段值在集合中查找记录
  • BulkCreateRecords: 一次性在集合中创建多条记录
  • BulkUpdateRecords: 一次性更新集合中的多条记录
  • BulkDeleteRecords: 一次性从集合中删除多条记录
  • OpenBrowser: 打开网页浏览器进行身份验证和设置
  • HelpAddToClient: 获取将Astra DB客户端添加到您的MCP客户端的帮助
  • EstimateDocumentCount: 获取集合中文档数量的估算值。

相关 MCP 服务