cdm-mcp-server
If you are the rightful owner of cdm-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
CDM MCP Server is a FastAPI-based service enabling AI assistants to interact with Delta Lake tables stored in MinIO through Spark, implementing the Model Context Protocol (MCP) for natural language data operations.
CDM MCP Server
A FastAPI-based service that enables AI assistants to interact with Delta Lake tables stored in MinIO through Spark, implementing the Model Context Protocol (MCP) for natural language data operations.
⚠️ Important Warning:
This service allows arbitrary
read-orientedqueries to be executed against Delta Lake tables. Query results will be sent to the model host server, unless you are hosting your model locally.
❌ Additionally, this service is NOT approved for deployment to any production environment, including CI, until explicit approval is granted by KBase leadership. Use strictly for local development or evaluation purposes only.
Documentation
For detailed documentation, please refer to the . The guide covers:
- - Bring the local service up and running
- - Set up local test data
- - Direct API usage examples
- - Configure and use with MCP Host tools
- - Create
mcp.json - - Configure MCP Host
- - Natural language examples
- - Create
Quick Start
-
Clone the repository:
git clone https://github.com/kbase/cdm-mcp-server.git cd cdm-mcp-server -
Create required directories:
mkdir -p cdr/cdm/jupyter/cdm_shared_workspace -
Create Docker network:
docker network create cdm-jupyterhub-network -
Start the services:
docker-compose up -d --build -
Access the services:
- MCP Server: http://localhost:8000/docs
- MinIO Console: http://localhost:9003
- Spark Master UI: http://localhost:8090
- JupyterHub: http://localhost:4043
Testing
# Install dependencies (only required on first run or when the uv.lock file changes)
uv sync --locked
# Run tests
PYTHONPATH=. uv run pytest tests
# Run with coverage
PYTHONPATH=. uv run pytest --cov=src tests/
