Astra DB MCP Server

Astra DB MCP サーバー

Astra DB と連携するための Model Context Protocol（MCP）サーバーです。MCP は、LLM がエージェントとして外部システムと連携できるようにすることで、その機能を拡張します。

前提条件

稼働中の Astra DB データベースが必要です。お持ちでない場合は、こちらから無料のデータベースを作成できます。作成後、以下の 2 つが必要になります。

1. Astra DB アプリケーショントークン
2. Astra DB API エンドポイント

これらの取得方法については、スタートガイドのドキュメントをお読みください。

MCP クライアントへの追加

このサーバーを MCP クライアントに追加する方法は次のとおりです。

IBM Bob

IBM Bob IDE では、こちらのドキュメントの手順に従ってください。

IBM Bob Shell では、こちらのドキュメントの手順に従ってください。

Claude Desktop

Claude Desktop に追加するには、Preferences -> Developer -> Edit Config を開き、以下の 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"
      }
    }
  }
}

オプションのキースペース設定： デフォルトでは、このサーバーは基盤となる Astra DB ライブラリで設定されているキースペース（通常は default_keyspace）を使用します。特定のキースペースに接続する必要がある場合は、上記の env オブジェクトに ASTRA_DB_KEYSPACE 変数を次のように追加できます。

"env": {
  "ASTRA_DB_APPLICATION_TOKEN": "your_astra_db_token",
  "ASTRA_DB_API_ENDPOINT": "your_astra_db_endpoint",
  "ASTRA_DB_KEYSPACE": "your_desired_keyspace"
}

Windows PowerShell ユーザー向け： npx はバッチコマンドなので、JSON を次のように変更してください。

  "command": "cmd",
  "args": ["/k", "npx", "-y", "@datastax/astra-db-mcp"],

Cursor

Cursor に追加するには、Settings -> Cursor Settings -> MCP を開きます。

そこから「+ Add New MCP Server」ボタンをクリックしてサーバーを追加すると、mcp.json ファイルが表示されます。

ヒント：グローバル MCP 設定を表す ~/.cursor/mcp.json と、プロジェクト固有の .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_KEYSPACE は省略可能です。省略した場合は、Astra DB ライブラリで設定されているデフォルトのキースペースが使用されます。

追加すると、エディターが Astra DB データベースに完全に接続されます。

利用可能なツール

このサーバーは、コレクション、ベクトル検索、テーブル、キースペース、管理機能にわたる包括的なツール群を提供します。

📁 コレクションとドキュメント

• GetCollections：アクティブなキースペース内のすべてのコレクションを取得します
• GetCollectionInfo：コレクションのオプション、ベクトル設定、デフォルトの ID 設定を確認します
• CreateCollection：ベクトルオプション、距離メトリクス（cosine、euclidean、dot_product）、自動ベクトル化設定を指定してコレクションを作成します
• UpdateCollection：コレクションを更新または名前変更します
• DeleteCollection：コレクションを削除します
• EstimateDocumentCount：コレクション内のドキュメントのおおよその件数を取得します
• ListRecords：任意の並べ替え、ページネーション（skip）、射影を指定してレコードを一覧表示します
• GetRecord：ID を指定して特定のレコードを取得します
• CreateRecord：単一のドキュメントを挿入します
• UpdateRecord：レコードを更新します
• DeleteRecord：ID を指定してレコードを削除します
• FindRecord：フィールド値の完全一致でレコードを検索します
• FindWithFilter：MongoDB 形式のフィルター演算子（$and、$or、$gt、$in、$exists など）を使用した高度なクエリを実行します
• FindDistinctValues：コレクション内の特定のフィールドについて、一意の値を検索します
• BulkCreateRecords：複数のドキュメントを一括挿入します
• BulkUpdateRecords：複数のドキュメントを一括更新します
• BulkDeleteRecords：複数のドキュメントを一括削除します

🧠 ベクトル検索と再ランキング

• FindWithVector：任意のメタデータフィルター、類似度スコア、射影を指定して、高密度ベクトル類似検索を実行します
• FindWithVectorize：Astra DB Vectorize のサーバーレス埋め込みを使用して、自然言語の検索クエリを実行します
• FindAndRerank：サーバー側の再ランキングスコアを使用して、ハイブリッド検索（語彙検索＋高密度ベクトル／自動ベクトル化）を実行します
• VectorSearch：最小スコアのしきい値と射影を指定して、ベクトル類似検索を実行します
• HybridSearch：高密度ベクトル類似検索とテキスト検索を重み付けスコアで組み合わせます

📊 テーブル（Astra DB Data API v2）

• ListTables：キースペース内のすべての構造化テーブルを一覧表示します
• CreateTable：列定義と主キーを指定して、型付きテーブルを作成します
• AlterTable：列（ベクトル列を含む）を追加または削除します
• DropTable：テーブルを削除します
• QueryTable：フィルター、並べ替え、射影、ページネーションを指定してテーブルの行をクエリします
• InsertTableRow：単一の行、または複数の行をテーブルに挿入します
• UpdateTableRow：テーブル内の該当する行を更新します
• DeleteTableRow：テーブル内の該当する行を削除します
• CreateTableIndex：テーブル列にセカンダリーインデックスを作成します
• CreateTableVectorIndex：類似度メトリクスを指定して、テーブル列にベクトルインデックスを作成します

🔑 キースペースと管理

• ListKeyspaces：データベース内のすべてのキースペースを一覧表示します
• CreateKeyspace：自動切り替えを任意で指定して、新しいキースペースを作成します
• DropKeyspace：キースペースを削除します
• UseKeyspace：後続の操作で使用するアクティブなキースペースを切り替えます
• GetCurrentKeyspace：アクティブなキースペース名を確認します
• ListEmbeddingProviders：対応する埋め込みモデルとプロバイダーを確認します
• ListRerankingProviders：対応する再ランキングモデルを確認します
• GetDatabaseInfo：環境メタデータ（ID、リージョン、ステータス、キースペース）を取得します

🛠️ ユーティリティ

• OpenBrowser：認証／セットアップ用のブラウザーを開きます
• HelpAddToClient：MCP クライアントのインストールを支援します

変更履歴

このプロジェクトの重要な変更はすべてこのファイルに記録されます。 形式はKeep a Changelogに基づいており、このプロジェクトはセマンティック バージョニングに準拠しています。

評価の実行

evals パッケージは MCP クライアントを読み込み、そのクライアントが index.ts ファイルを実行するため、テストのたびに再ビルドする必要はありません。npx コマンドの前に環境変数を指定すると、環境変数を読み込めます。詳細なドキュメントはこちらをご覧ください。

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts tools.ts

❤️ 貢献者

Badges