mcp/astra-db

Verified Publisher

By mcp

•Updated 6 months ago

An MCP server for Astra DB workloads

Image

Machine learning & AI

9.7K

View on MCP:Hub

Overview Tags

mcp/astra-db repository overview

⁠Astra DB MCP Server

An MCP server for Astra DB workloads.

What is an MCP Server?⁠

⁠MCP Info

Attribute	Details
Docker Image	mcp/astra-db⁠
Author	datastax⁠
Repository	https://github.com/datastax/astra-db-mcp⁠

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/datastax/astra-db-mcp/blob/da7da00667ed07593a664e6cdfb754f9e18c1867/Dockerfile⁠
Commit	`da7da00667ed07593a664e6cdfb754f9e18c1867`
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 (19)

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
`FindDistinctValues`	Find distinct values for a field in a collection
`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
`HybridSearch`	Search for records using both vector similarity and text matching
`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
`VectorSearch`	Search for records in a collection using vector similarity

⁠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`	`number` optional	The dimensions of the vector collection, if vector is true
`metric`	`string` optional	The similarity metric to use for vector search (cosine, euclidean, or dot_product)
`vector`	`boolean` optional	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: `FindDistinctValues`

Find distinct values for a field in a collection

Parameters	Type	Description
`collectionName`	`string`	Name of the collection to search in
`field`	`string`	Field name to find distinct values for
`filter`	`object` optional	Optional filter to apply before finding distinct values

⁠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`	`number` optional	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: `HybridSearch`

Search for records using both vector similarity and text matching

Parameters	Type	Description
`collectionName`	`string`	Name of the collection to search in
`queryVector`	`array`	The vector to search for similar vectors
`textQuery`	`string`	The text query to search for
`fields`	`array` optional	Fields to search in for text matching
`limit`	`number` optional	Maximum number of records to return
`weights`	`object` optional	Weights for vector and text components

⁠Tool: `ListRecords`

List records from a collection in the database

Parameters	Type	Description
`collectionName`	`string`	Name of the collection to list records from
`limit`	`number` optional	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

⁠Tool: `VectorSearch`

Search for records in a collection using vector similarity

Parameters	Type	Description
`collectionName`	`string`	Name of the collection to search in
`queryVector`	`array`	The vector to search for similar vectors
`filter`	`object` optional	Additional filter criteria for the search
`limit`	`number` optional	Maximum number of records to return
`minScore`	`number` optional	Minimum similarity score (0.0 to 1.0)

⁠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"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Install from MCP:Hub

Astra DB

View and Install from MCP:Hub

Tag summary

Recent tags

Content type

Image

Digest

sha256:8c1bc87a2…

Size

91.8 MB

Last updated

6 months ago

docker pull mcp/astra-db

This week's pulls

Pulls:

1,415

Last week

Learn more⁠

mcp/astra-db

mcp/astra-db repository overview

⁠Astra DB MCP Server

⁠MCP Info

⁠Image Building Info

⁠Available Tools (19)

⁠Tools Details

⁠Tool: BulkCreateRecords

⁠Tool: BulkDeleteRecords

⁠Tool: BulkUpdateRecords

⁠Tool: CreateCollection

⁠Tool: CreateRecord

⁠Tool: DeleteCollection

⁠Tool: DeleteRecord

⁠Tool: EstimateDocumentCount

⁠Tool: FindDistinctValues

⁠Tool: FindRecord

⁠Tool: GetCollections

⁠Tool: GetRecord

⁠Tool: HelpAddToClient

⁠Tool: HybridSearch

⁠Tool: ListRecords

⁠Tool: OpenBrowser

⁠Tool: UpdateCollection

⁠Tool: UpdateRecord

⁠Tool: VectorSearch