Astra DB

JEStats Astra DB Plugin · @erichare/astra-mcp

JEStatsによる非公式のコミュニティ運営 Astra DB 統合です。DataStax または IBM との提携や、両社による推奨はありません。ライブデータツール、保護された書き込み、ベクトル検索とハイブリッド検索、インタラクティブなMCP Appsビュー、約1,660件の同梱 Data API サンプルを備えた MCP サーバーです。また、Claude Code、Codex、Cursor、VS Code、Windsurf、Gemini CLI、Claude Desktop、IBM Bob 向けのワンコマンドインストーラーも含まれています。

npx -y @erichare/astra-mcp init

init はエージェントを検出し、それぞれを設定します。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	エージェントを設定します：--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 の衛生状態、エージェントの設定を確認します（--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

破壊的な操作には、elicitation またはユーザーの承認後に指定する明示的な confirm 引数によるユーザーの確認が必要です。認証情報は、環境変数、プロジェクトの .env、ホスト設定、login --global、Astra CLI の ~/.astrarc の順に参照されます。

このパッケージはすべてを1つのファイルにまとめており、実行時の依存関係はありません。2.0.0 以降のリリースは、npm provenance を有効にして GitHub Actions から公開されています。

ドキュメント、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 の公式製品ではありません。