Overview
Astra DB MCP Server is a Model Context Protocol (MCP) server designed for interacting with Astra DB workloads, enhancing the capabilities of Large Language Models (LLMs) by enabling them to act as agents that interact with external systems.
To use the Astra DB MCP Server, you need to have a running Astra DB database. After creating a free database, obtain your Astra DB Application Token and API Endpoint. Then, configure your MCP client (like Claude Desktop or Cursor) to connect to the server using the provided JSON configuration.
- Integration with Astra DB for seamless database interactions. - Tools for managing collections and records in the database. - Support for multiple MCP clients, enhancing flexibility.
- Managing database collections and records through an MCP client.
- Enhancing LLM capabilities by allowing them to interact with Astra DB.
- Facilitating data operations in applications that require database access.
Add to your AI client
Use these steps to connect Astra DB MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"astra-db-mcp-datastax": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"astra-db-mcp-datastax": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"astra-db-mcp-datastax": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"astra-db-mcp-datastax": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"astra-db-mcp-datastax": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"astra-db-mcp-datastax": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-astra-db-mcp-datastax"
]
}
}
}FAQ
What is required to use the Astra DB MCP Server?
You need a running Astra DB database, an application token, and the API endpoint.
Can I use this server with any MCP client?
Yes, it supports multiple MCP clients like Claude Desktop and Cursor.
Is there any cost associated with using Astra DB?
Astra DB offers a free tier for users to get started.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2782,"uuid":"c4df3b08-073a-446b-8e37-8dabf742be17","name":"astra-db-mcp","title":"Astra DB MCP Server","description":"An MCP server for Astra DB workloads","avatar_url":"https://avatars.githubusercontent.com/u/573369?v=4","created_at":"2025-03-14T01:49:27.092Z","updated_at":"2025-03-14T02:26:43.160Z","status":"created","author_name":"datastax","author_avatar_url":"https://avatars.githubusercontent.com/u/573369?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/datastax/astra-db-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/b854b10299ef79d974bd9e6bb8d30a0684c15de600e58d9cb5575987202f6f3a/68747470733a2f2f676c616d612e61692f6d63702f736572766572732f746967697830796634622f6261646765","type":null,"metadata":"{\"star\":\"13\",\"license\":\"Apache-2.0 license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-04-03 13:45:16\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]