Astra DB

Prerequisites

You need to have a running Astra DB database. If you don't have one, you can create a free database here. From there, you can get two things you need: 1. An Astra DB Application Token 2. The Astra DB API Endpoint To learn how to get these, please read the getting started docs.

Adding to an MCP client

Here's how you can add this server to your MCP client.

Claude Desktop

To add this to Claude Desktop, go to Preferences -> Developer -> Edit Config and add this JSON blob to 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" } } } }

Optional Keyspace Configuration: By default, this server uses the keyspace configured in the underlying Astra DB library (typically default_keyspace). If you need to connect to a specific keyspace, you can add the ASTRA_DB_KEYSPACE variable to the env object above.

Cursor

To add this to Cursor, go to Settings -> Cursor Settings -> MCP From there, you can add the server by clicking the "+ Add New MCP Server" button, where you should be brought to an mcp.json file. Add the same JSON as indicated in the Claude Desktop instructions.

Available Tools

The server provides the following tools for interacting with Astra DB:

• GetCollections: Get all collections in the database
• CreateCollection: Create a new collection in the database
• UpdateCollection: Update an existing collection in the database
• DeleteCollection: Delete a collection from the database
• ListRecords: List records from a collection in the database
• GetRecord: Get a specific record from a collection by ID
• CreateRecord: Create a new record in a collection
• UpdateRecord: Update an existing record in a collection
• DeleteRecord: Delete a record from a collection
• FindRecord: Find records in a collection by field value
• BulkCreateRecords: Create multiple records in a collection at once
• BulkUpdateRecords: Update multiple records in a collection at once
• BulkDeleteRecords: Delete multiple records from a collection at once
• OpenBrowser: Open a web browser for authentication and setup
• HelpAddToClient: Get assistance with adding Astra DB client to your MCP client
• EstimateDocumentCount: Get estimate of the number of documents in a collection

Changelog

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.