Skip to content

v0.0.1 Hello World

Choose a tag to compare

View all tags
@smatiolids smatiolids released this 01 Oct 20:31
· 34 commits to main since this release
v0.0.1
3c70e93

Astra MCP Server v0.0.1 Release Description

🎉 Initial Release - Astra MCP Server

This is the first release of the Astra MCP Server, a Model Context Protocol (MCP) server that enables seamless integration between AI applications and DataStax Astra DB.

✨ Key Features

🔗 Astra DB Integration

  • Integration with DataStax Astra DB using the official astrapy client
  • Support for both HTTP and STDIO transport protocols
  • Configurable database connection via environment variables

🛠️ Dynamic Tool System

  • Configurable tool catalog system supporting both file-based and Astra collection-based configurations
  • Built-in database tools: find_documents and list_collections
  • Support for vector search operations with $vectorize queries

🚀 Flexible Deployment

  • Command-line interface with comprehensive argument parsing
  • Support for both development (--reload) and production modes
  • Configurable host, port, and logging settings
  • Easy installation via uv package manager

📊 Advanced Features

  • Comprehensive logging system with configurable levels and file output
  • Middleware support for custom tool execution workflows
  • Utility functions for data transformation and key renaming
  • Support for projection, filtering, and pagination in database queries

🔧 Developer Experience

  • Support for MCP Inspector for debugging and testing
  • Environment-based configuration management

📦 Installation & Usage

# Quick start from GitHub
uvx git+https://github.com/smatiolids/astra-mcp-server.git

# Local development
uv sync
uv run astra-mcp-server --host 127.0.0.1 --port 5150 --reload --log-level debug

🎯 Use Cases

  • RAG Applications: Vector search and retrieval from Astra collections
  • Product Search: Configurable product search with filtering capabilities
  • FAQ Systems: Question-answering systems using vectorized content
  • Custom Database Operations: Flexible tool configuration for specific use cases

🔧 Configuration

The server supports configuration via:

  • Environment variables (.env file)
  • Command-line arguments
  • JSON configuration files
  • Astra DB collections for tool catalogs

📋 Requirements

  • Python 3.12+
  • DataStax Astra DB account
  • Required dependencies: astrapy, fastmcp, uvicorn, python-dotenv

This initial release provides a solid foundation for building AI applications that interact with Astra DB through the Model Context Protocol, with extensive customization options and developer-friendly tooling.

Assets 4
Loading