Astra DB MCP Server

Astra DB MCP Server

site icon
2025.04.04 17
TypeScript数据库管理LLM 扩展数据库
Astra DB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于与 Astra DB 数据库进行交互。它扩展了大型语言模型 (LLMs) 的能力,使其能够作为代理与外部系统交互。该服务器提供了丰富的工具集,用于管理数据库中的集合和记录,包括创建、更新、删除和查询等操作。
View on GitHub

Overview

基本能力

产品定位

Astra DB MCP Server 是一个数据库交互工具,旨在通过 MCP 协议扩展 LLMs 的能力,使其能够直接操作 Astra DB 数据库。

核心功能

  • 管理数据库集合:创建、更新、删除集合
  • 管理记录:创建、更新、删除、查询记录
  • 批量操作:支持批量创建、更新、删除记录
  • 辅助功能:提供帮助工具和浏览器认证支持

适用场景

  • 开发者在 LLMs 应用中集成数据库操作
  • 需要自动化管理 Astra DB 数据库的场景
  • 批量数据处理任务

工具列表

  • GetCollections: 获取所有集合
  • CreateCollection: 创建新集合
  • UpdateCollection: 更新集合
  • DeleteCollection: 删除集合
  • ListRecords: 列出集合中的记录
  • GetRecord: 按 ID 获取记录
  • CreateRecord: 创建新记录
  • UpdateRecord: 更新记录
  • DeleteRecord: 删除记录
  • FindRecord: 按字段值查找记录
  • BulkCreateRecords: 批量创建记录
  • BulkUpdateRecords: 批量更新记录
  • BulkDeleteRecords: 批量删除记录
  • OpenBrowser: 打开浏览器进行认证
  • HelpAddToClient: 获取添加客户端帮助
  • EstimateDocumentCount: 估算集合文档数量

常见问题

  • 需要先创建 Astra DB 数据库并获取应用令牌和 API 端点
  • Windows PowerShell 用户需要特殊配置
  • 可以添加到 Claude Desktop 和 Cursor 等 MCP 客户端

使用教程

使用依赖

  1. 需要一个运行的 Astra DB 数据库
  2. 获取 Astra DB 应用令牌和 API 端点

安装教程

添加到 Claude Desktop

  1. 打开 Preferences -> Developer -> Edit Config
  2. 添加以下配置到 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"
      }
    }
  }
}

添加到 Cursor

  1. 打开 Settings -> Cursor Settings -> MCP
  2. 添加服务器配置
  3. 使用以下命令格式:
env ASTRA_DB_APPLICATION_TOKEN=your_astra_db_token ASTRA_DB_API_ENDPOINT=your_astra_db_endpoint npx -y @datastax/astra-db-mcp

调试方式

  1. 确保环境变量设置正确
  2. 检查 MCP 客户端连接状态
  3. 使用提供的工具进行测试操作

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。