The Astra DB MCP Server enables interaction with an Astra DB database to manage collections and records. With this server, you can:
Manage Collections:
Get all collections
Create new collections
Update existing collections
Delete collections
Manage Records:
List records from a collection
Get a specific record by ID
Create a new record (or multiple records at once)
Update existing records (individually or in batch)
Delete records (individually or in batch)
Find records by field value
Utilities:
Open a browser for authentication and setup
Get help adding the client to an MCP client
Estimate document count in a collection
Allows to interact with Astra DB, a database service by DataStax. Provides tools for collection management (creating, updating, deleting, listing) and record operations (creating, retrieving, updating, deleting).
Astra DB MCP Server
A Model Context Protocol (MCP) server for interacting with Astra DB. MCP extends the capabilities of Large Language Models (LLMs) by allowing them to interact with external systems as agents.
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:
- An Astra DB Application Token
- 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
:
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, like so:
Windows PowerShell Users:
npx
is a batch command so modify the JSON as follows:
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.
Tip: there is a
~/.cursor/mcp.json
that represents your Global MCP settings, and a project-specific.cursor/mcp.json
file that is specific to the project. You probably want to install this MCP server into the project-specific file.
Add the same JSON as indiciated in the Claude Desktop instructions.
Alternatively you may be presented with a wizard, where you can enter the following values (for Unix-based systems):
- Name: Whatever you want
- Type: Command
- Command:
Note: ASTRA_DB_KEYSPACE
is optional. If omitted, the default keyspace configured in the Astra DB library will be used.
Once added, your editor will be fully connected to your Astra DB database.
Available Tools
The server provides the following tools for interacting with Astra DB:
GetCollections
: Get all collections in the databaseCreateCollection
: Create a new collection in the databaseUpdateCollection
: Update an existing collection in the databaseDeleteCollection
: Delete a collection from the databaseListRecords
: List records from a collection in the databaseGetRecord
: Get a specific record from a collection by IDCreateRecord
: Create a new record in a collectionUpdateRecord
: Update an existing record in a collectionDeleteRecord
: Delete a record from a collectionFindRecord
: Find records in a collection by field valueBulkCreateRecords
: Create multiple records in a collection at onceBulkUpdateRecords
: Update multiple records in a collection at onceBulkDeleteRecords
: Delete multiple records from a collection at onceOpenBrowser
: Open a web browser for authentication and setupHelpAddToClient
: Get assistance with adding Astra DB client to your MCP clientEstimateDocumentCount
: 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.
Running evals
The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.
❤️ Contributors
Badges
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Model Context Protocol server that allows Large Language Models to interact with Astra DB databases, providing tools for managing collections and records through natural language commands.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to interact directly with MongoDB databases, allowing users to query collections, inspect schemas, and manage data through natural language.Last updated -123MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.Last updated -MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that enables large language models to interact with Apache Superset databases through REST API, supporting database queries, table lookups, field information retrieval, and SQL execution.Last updated -45
MCP TapData Serverofficial
-securityFlicense-qualityA Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.Last updated -