Cassandra, three ways
List permitted tables, inspect schema and read a bounded partition. Node.js, Python and Java share the same three-tool contract.
Open source / MCP & decision systems
Tools you can inspect. Agents you can test.
Build with bounded Cassandra tools, repair agent guardrails, and explore typed decision agents in Java. Every implementation has a clear scope and a testable contract.
3Cassandra runtimes
8Interactive experiments
100Runnable agent recipes
16Architecture guides
A useful place to start
Choose your next build.
Original implementations, lessons and exercises by Sandeep Belgavi.
Break it. Repair it. Explain it.
Repair a guardrail pipeline, challenge a decision contract, minimize evidence, reserve budgets and inspect safe query plans.
100 bounded recipes
Support, security, cloud, data and more. Run synthetic examples or connect the optional Jev adapter with your own key.
What is available: source releases and tested local code. Cassandra live-cluster validation and paid Jev calls have not been performed. Agent recipes produce recommendations; they do not execute business effects. No npm package or hosted MCP endpoint is advertised.
One contract / three implementations
Run Cassandra MCP your way.
Use a dedicated SELECT-only role, exact table allowlists and TLS. Credentials belong in your client’s secret configuration.
Node.js setup
Node.js 22 or newer. Launch src/cli.js through your MCP client.
git clone https://github.com/Sandeep-BA/cassandra-mcp.git
cd cassandra-mcp
git checkout v0.2.0
npm ci --ignore-scripts
npm testPython setup
Python 3.11 or 3.12. Commands run from the cloned repository; replace <venv-python> with its path.
python -m venv implementations/python/.venv
# Use the venv interpreter: bin/python on POSIX, Scripts/python.exe on Windows
<venv-python> -m pip install -e "implementations/python[test]"
<venv-python> -m pytest implementations/python/testsJava setup
Java 17+ and Maven 3.9+. Commands run from the cloned repository. The JAR waits for an MCP client.
mvn -f implementations/java/pom.xml verify
java -jar implementations/java/target/cassandra-mcp.jarSkills for careful integration.
Three focused skills cover server selection, Cassandra setup and contract testing. They are instructions for an agent—not software installers or account permissions.
Read and install the skills →Jev, LLMs and decision systems.
Twelve source-linked guides cover contracts, calibration, abuse prevention, Java adapters, ADK composition, evaluation and proposed GCP deployment.
Read harness engineering Read the architecture series →Learn the protocol by doing.
Continue with the tool registry lab, MCP articles and Cassandra engineering guides. The browser labs use synthetic scenarios and do not connect to your database.