Astra DB MCP 服务器

这是一个用于与 Astra DB 交互的模型上下文协议（MCP）服务器。MCP 通过允许大型语言模型（LLM）作为代理与外部系统交互，扩展了它们的能力。

前提条件

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

1. Astra DB 应用程序令牌
2. Astra DB API 端点

要了解如何获取这些信息，请阅读入门文档。

添加到 MCP 客户端

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

Claude Desktop

要将此添加到 Claude Desktop，请转到首选项 -> 开发者 -> 编辑配置，并将以下 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 设置 -> MCP。

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

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

添加与 Claude Desktop 指令中相同的 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：获取集合中文档数量的估计值

更新日志

此项目的所有显著更改都将记录在此文件中。 格式基于保持更新日志，并且此项目遵循语义化版本控制。

❤️ 贡献者