Astra DB MCP Server

Name: Astra DB MCP Server
Author: datastax

@datastax

代码仓库

关于 Astra DB MCP Server

An MCP server for Astra DB workloads

#astra #db #mcp #database #server

基本信息

分类

数据库

许可证

Apache-2.0

运行时

node

传输方式

stdio

发布者

datastax

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Astra DB MCP Server?

A Model Context Protocol (MCP) server for interacting with Astra DB. It extends LLMs by allowing them to act as agents that can manage collections, perform CRUD operations, run vector and hybrid search, and execute bulk data operations on an Astra DB database.

How to use Astra DB MCP Server?

Install by running npx -y @datastax/astra-db-mcp with the required environment variables ASTRA_DB_APPLICATION_TOKEN and ASTRA_DB_API_ENDPOINT. Optionally set ASTRA_DB_KEYSPACE to target a specific keyspace. Add the server to an MCP client such as Claude Desktop or Cursor by editing their configuration JSON.

Key features of Astra DB MCP Server

Collection management: create, update, delete, and list collections
Vector search and hybrid search on embeddings
CRUD operations on individual records
Bulk create, update, and delete records
Find records by field value and distinct values
Estimate document count in a collection

Use cases of Astra DB MCP Server

Let an LLM agent read and write data to an Astra DB database
Power semantic search with vector similarity on embeddings
Perform hybrid retrieval combining vector and text queries
Manage and bulk-load records in collections via natural language

FAQ from Astra DB MCP Server

What prerequisites are needed to run this server?

You need an active Astra DB database, an Astra DB Application Token, and the Astra DB API Endpoint. A free database can be created at the Astra DB registration page.

Which MCP clients are supported?

The README provides setup instructions for Claude Desktop and Cursor. Other MCP clients that accept a command-based server may also work.

How do I configure a specific keyspace?

Add the ASTRA_DB_KEYSPACE environment variable to the server configuration. If omitted, the default keyspace configured in the underlying Astra DB library is used.

Can I perform vector search with this server?

Yes. The server provides VectorSearch for similarity search on embeddings and HybridSearch that combines vector similarity with text search. Both support configurable limits, filters, and scoring.