Astra DB

io.github.erichare由 GitHub 帳號 erichare 發布v2.0.0更新於 Oct 24, 2026

Astra DB tools for agents: schema, find, vector search, guarded writes, and interactive views.

已驗證Streamable HTTP可網頁執行資料庫開發者工具

概覽

AI 產生的概覽

社群維護的 Astra DB MCP 伺服器，讓助理檢視結構、查詢與向量檢索集合，並在確認後執行受保護的寫入。

可以做什麼
  • 檢查連線狀態並列出資料庫
  • 檢視集合與資料表結構、資料庫概觀和向量化供應商
  • 使用 find、向量檢索、計數與去重取值進行查詢
  • 查閱內建的 Data API 程式碼範例
  • 插入、更新、刪除，建立集合、資料表與索引，以及刪除物件
適用情境
適合需要讓助理操作 Astra DB 資料庫的情境：探索結構、執行讀取與向量或混合檢索、撰寫 Data API 程式碼，或在確認後修改資料。它也提供一條指令為多種程式開發助理完成設定。
執行需求
npm 套件需要 Node.js 20+，也可使用帶 OAuth 的遠端託管端點。需要 Astra DB 應用程式權杖（ASTRA_DB_APPLICATION_TOKEN），通常還需 Data API 端點（ASTRA_DB_API_ENDPOINT），keyspace 為選用。憑證可來自環境變數、專案 .env 或 Astra CLI 設定。
安裝前請注意
該權杖可存取你的 Astra 資料庫。寫入與結構工具（insert、update、delete、create、drop）會變更資料；破壞性操作需使用者確認，唯讀模式會隱藏寫入工具。初始化指令會把連線設定寫入 .env 檔案。這是非官方社群專案，並非 DataStax 或 IBM 官方產品。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Astra DB，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.erichare%2Fastra-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "astra-db": {
      "type": "http",
      "url": "https://astra-widgets-mcp.vercel.app/mcp"
    }
  }
}

README

JEStats Astra DB Plugin · @erichare/astra-mcp

Unofficial, community-maintained Astra DB integration by JEStats, not affiliated with or endorsed by DataStax or IBM. An MCP server with live data tools, guarded writes, vector and hybrid search, interactive MCP Apps views, and about 1,660 bundled Data API examples. It also includes a one-command installer for Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop, and IBM Bob.

bash
npx -y @erichare/astra-mcp init

init detects your agents and configures each one. Its login step reuses an existing credential source or asks for an Astra application token with hidden input, lets you pick a database, and writes connection settings to a git-ignored .env. There's no restart: the server re-reads credentials on every call. Requires Node.js 20+.

Already configured the Astra CLI? Run login --profile analytics to choose a database from a named profile, or use init --no-login followed by doctor to reuse the default configuration directly. Profile login stores only the profile/config selector and connection details, keeping the token in .astrarc. The npm package name stays unchanged for compatibility.

Commands

astra-mcpServe MCP over stdio (the default when stdin isn't a terminal)
astra-mcp initConfigure agents: --agents a,b, --project, --dry-run, --yes, --no-login
astra-mcp loginConnect a database: --profile, --astrarc, --astra-env, --global, --database, --keyspace, --endpoint, --token-stdin
astra-mcp doctorCheck credentials, connectivity, .env hygiene, and agent setup (--json)
astra-mcp uninstallUndo init
astra-mcp serve --read-onlyServe without the write tools
astra-mcp bob-bundle --out <zip>Build the IBM Bob bundle

As an MCP server

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

The 18 tools:

  • Connect: connection_status, list_databases
  • Explore: database_overview, describe_collection, describe_table, list_vectorize_providers
  • Query: find, vector_search, count, distinct_values
  • Build: code_examples
  • Change: insert, update, delete, create_collection, create_table, create_index, drop

Destructive operations need the user's confirmation, through elicitation or an explicit confirm argument after the user approves. Credentials come from the environment, then the project's .env, host settings, login --global, and the Astra CLI's ~/.astrarc.

The package bundles everything into one file with no runtime dependencies. Releases after 2.0.0 are published from GitHub Actions with npm provenance.

Documentation, the Claude Code and Codex plugin, and the hosted OAuth endpoint for ChatGPT and claude.ai: github.com/jestatsio/astra-db-plugin.

Apache-2.0 for this plugin's own code. Includes documentation-derived examples vendored from sl-at-ibm/astra-toolkit-skill; see the bundled NOTICE for attribution and upstream licensing status. Community project, not an official DataStax or IBM product.

來源：server/README.md，提交 da4660c

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v2.0.0最新Sep 24, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分