Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
Astra DB MCP Server
An MCP server for Astra DB workloads.
Characteristics
| Attribute | Details |
|---|---|
| Docker Image | mcp/astra-db |
| Author | datastax |
| Repository | https://github.com/datastax/astra-db-mcp |
| Dockerfile | https://github.com/datastax/astra-db-mcp/blob/refs/pull/14/merge/Dockerfile |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/astra-db --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | Apache License 2.0 |
Available Tools (16)
| Tools provided by this Server | Short Description |
|---|---|
BulkCreateRecords | Create multiple records in a collection at once |
BulkDeleteRecords | Delete multiple records from a collection at once |
BulkUpdateRecords | Update multiple records in a collection at once |
CreateCollection | Create a new collection in the database |
CreateRecord | Create a new record in a collection |
DeleteCollection | Delete a collection from the database |
DeleteRecord | Delete a record from a collection |
EstimateDocumentCount | Estimate the number of documents in a collection using a fast, approximate count method |
FindRecord | Find records in a collection by field value |
GetCollections | Get all collections in the Astra DB database |
GetRecord | Get a specific record from a collection by ID |
HelpAddToClient | Help the user add the Astra DB client to their MCP client |
ListRecords | List records from a collection in the database |
OpenBrowser | Open a web browser to a specific URL |
UpdateCollection | Update an existing collection in the database |
UpdateRecord | Update an existing record in a collection |
Tools Details
Tool: BulkCreateRecords
Create multiple records in a collection at once
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to create the records in |
records | array | Array of records to insert |
Tool: BulkDeleteRecords
Delete multiple records from a collection at once
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection containing the records |
recordIds | array | Array of record IDs to delete |
Tool: BulkUpdateRecords
Update multiple records in a collection at once
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection containing the records |
records | array | Array of records to update with their IDs |
Tool: CreateCollection
Create a new collection in the database
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to create |
dimension | numberoptional | The dimensions of the vector collection, if vector is true |
vector | booleanoptional | Whether to create a vector collection |
Tool: CreateRecord
Create a new record in a collection
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to create the record in |
record | object | The record data to insert |
Tool: DeleteCollection
Delete a collection from the database
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to delete |
Tool: DeleteRecord
Delete a record from a collection
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection containing the record |
recordId | string | ID of the record to delete |
Tool: EstimateDocumentCount
Estimate the number of documents in a collection using a fast, approximate count method
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to estimate document count for |
Tool: FindRecord
Find records in a collection by field value
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to search in |
field | string | Field name to search by (e.g., 'title', '_id', or any property) |
value | string | Value to search for in the specified field |
limit | numberoptional | Maximum number of records to return |
Tool: GetCollections
Get all collections in the Astra DB database
Tool: GetRecord
Get a specific record from a collection by ID
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to get the record from |
recordId | string | ID of the record to retrieve |
Tool: HelpAddToClient
Help the user add the Astra DB client to their MCP client
Tool: ListRecords
List records from a collection in the database
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to list records from |
limit | numberoptional | Maximum number of records to return |
Tool: OpenBrowser
Open a web browser to a specific URL
| Parameters | Type | Description |
|---|---|---|
url | string | The URL to open in the browser |
Tool: UpdateCollection
Update an existing collection in the database
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection to update |
newName | string | New name for the collection |
Tool: UpdateRecord
Update an existing record in a collection
| Parameters | Type | Description |
|---|---|---|
collectionName | string | Name of the collection containing the record |
record | object | The updated record data |
recordId | string | ID of the record to update |
Use this MCP Server
{
"mcpServers": {
"astra-db": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ASTRA_DB_API_ENDPOINT",
"-e",
"ASTRA_DB_APPLICATION_TOKEN",
"mcp/astra-db"
],
"env": {
"ASTRA_DB_API_ENDPOINT": "",
"ASTRA_DB_APPLICATION_TOKEN": "your_astra_db_token"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for