Astra DB

Astra DB

MCP server enabling LLMs to manage Astra DB collections, records, and vector searches.

37
Stars
22
Forks
0
Releases

Overview

The Astra DB MCP Server is a Model Context Protocol server that enables language models to interact with DataStax Astra DB. It exposes a comprehensive set of tools for managing databases hosted in Astra DB, including collection-level operations (GetCollections, CreateCollection with vector support, UpdateCollection, DeleteCollection, and EstimateDocumentCount) and record-level operations (ListRecords, GetRecord, CreateRecord, UpdateRecord, DeleteRecord, FindRecord, and FindDistinctValues). The server also provides bulk processing capabilities (BulkCreateRecords, BulkUpdateRecords, BulkDeleteRecords) and vector-based search features (VectorSearch and HybridSearch) to support AI workloads. Enhanced collection creation supports enabling vector search, setting dimensions, and selecting similarity metrics. The tools are designed to integrate with MCP clients such as Claude Desktop and Cursor, with environment variable configuration via ASTRA_DB_APPLICATION_TOKEN and ASTRA_DB_API_ENDPOINT, and optional ASTRA_DB_KEYSPACE for targeting a specific keyspace. Additional utility commands like OpenBrowser and HelpAddToClient assist with authentication and client integration. The README highlights improved error handling and performance optimizations, and provides examples of usage.

Details

Owner
datastax
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

VectorSearch

Perform vector similarity search on embeddings within a collection, returning top results with optional limit and minScore, and supporting additional filters.

HybridSearch

Combine vector similarity with text search to improve results, with configurable weights and targeted fields.

Enhanced CreateCollection with Vector Support

CreateCollection now supports enabling vector search and configuring vector properties such as dimension and similarity metric.

FindDistinctValues

Find unique values for a specified field in a collection, with optional filtering.

Optimized Bulk Operations

BulkCreateRecords, BulkUpdateRecords, and BulkDeleteRecords use native batch processing for better performance.

CRUD and Listing Tools

Comprehensive collection and record management tools, including GetCollections, CreateCollection, UpdateCollection, DeleteCollection, ListRecords, GetRecord, CreateRecord, UpdateRecord, and DeleteRecord.

Improved Error Handling

Provides more detailed error messages with error codes to aid diagnostics and debugging.

Utility and Client Setup

Includes OpenBrowser and HelpAddToClient utilities to assist with authentication, setup, and MCP client integration.

Tags

Astra DBMCP ServerLLMVector SearchHybrid SearchBulk OperationsCollection ManagementRecord OperationsFindDistinctValuesOpenBrowserCursorClaude Desktop