Astra DB

JEStats Astra DB 插件 · @erichare/astra-mcp

由 JEStats 提供的非官方社区维护 Astra DB 集成，与 DataStax 或 IBM 无关联，也未获其认可。这是一个 MCP 服务，提供实时数据工具、受保护的写入、向量与混合搜索、交互式 MCP Apps 视图，以及约 1,660 个内置 Data API 示例。它还提供一条命令即可完成安装的安装程序，支持 Claude Code、Codex、Cursor、VS Code、Windsurf、Gemini CLI、Claude Desktop 和 IBM Bob。

npx -y @erichare/astra-mcp init

init 会检测你的 Agent 并为其逐一配置。其 login 步骤会复用现有凭据来源，或通过隐藏输入提示你提供 Astra 应用令牌；你可以选择一个数据库，连接设置会写入被 Git 忽略的 .env 文件。无需重启：服务会在每次调用时重新读取凭据。需要 Node.js 20+。

如果已经配置了 Astra CLI，可以运行 login --profile analytics，从命名配置文件中选择数据库；也可以运行 init --no-login，然后运行 doctor，直接复用默认配置。配置文件登录只会存储配置文件／配置选择器和连接详情，令牌仍保存在 .astrarc 中。npm 包名称保持不变，以确保兼容性。

命令

astra-mcp	通过 stdio 提供 MCP 服务（当 stdin 不是终端时的默认行为）
astra-mcp init	配置 Agent：--agents a,b、--project、--dry-run、--yes、--no-login
astra-mcp login	连接数据库：--profile、--astrarc、--astra-env、--global、--database、--keyspace、--endpoint、--token-stdin
astra-mcp doctor	检查凭据、连接状态、.env 卫生状况和 Agent 设置（--json）
astra-mcp uninstall	撤销 init 的更改
astra-mcp serve --read-only	不提供写入工具
astra-mcp bob-bundle --out <zip>	构建 IBM Bob 捆绑包

作为 MCP 服务

{ "mcpServers": { "astra-db": { "command": "npx", "args": ["-y", "@erichare/astra-mcp@2"] } } }

18 个工具：

• 连接： connection_status、list_databases
• 探索： database_overview、describe_collection、describe_table、list_vectorize_providers
• 查询： find、vector_search、count、distinct_values
• 构建： code_examples
• 更改： insert、update、delete、create_collection、create_table、create_index、drop

破坏性操作需要用户确认，可通过征询或在用户批准后提供显式的 confirm 参数。凭据依次来自环境变量、项目的 .env、主机设置、login --global，以及 Astra CLI 的 ~/.astrarc。

该软件包将所有内容打包为一个文件，没有运行时依赖。2.0.0 之后的版本通过 GitHub Actions 发布，并附带 npm 来源证明。

文档、Claude Code 和 Codex 插件，以及面向 ChatGPT 和 claude.ai 的托管 OAuth 端点：github.com/jestatsio/astra-db-plugin。

本插件自有代码采用 Apache-2.0 许可证。包含从文档整理而来的示例，这些示例来自 sl-at-ibm/astra-toolkit-skill；归属信息和上游许可状态请参阅随附的 NOTICE。这是社区项目，并非 DataStax 或 IBM 的官方产品。