Skip to content

Repository files navigation

Continuum

License: MIT CI

Continuum gives an MCP-compatible agent persistent memory: working, episodic, and semantic, backed by CockroachDB's distributed SQL and vector indexing. The point isn't just storing memory. It's proving the configuration behind it actually survives losing a whole cloud region, not just claiming it would.

Built for the CockroachDB × AWS "Build with Agentic Memory" Hackathon.

Live demo: https://continuum-mcp.fly.dev — the real MCP server (endpoint at /mcp, an MCP client speaks Streamable HTTP there, not a browsable page), running against the live multi-region cluster. Hosted on Fly.io rather than the originally-targeted AWS Lambda, since real AWS account access for the hackathon never came through in time.

Why

Most agent memory today is either nothing (every session starts blank) or a single vector store with everything dumped in as "semantic." That's not how memory actually works. What happened this turn needs different handling than what happened last week, which needs different handling than a durable fact about a user. And none of it matters if a region outage wipes it out the moment someone actually relies on it.

Continuum splits memory into three tiers with genuinely different access patterns, exposes them as MCP tools any agent can call, and runs on a CockroachDB cluster spread across 3 regions with REGION survival goal configured, the minimum CockroachDB requires to actually survive losing one. See SRS.md FR-3 for why that's demonstrated through configuration and a written explanation rather than a live region kill in the demo video.

Requirements and design rationale: SRS.md.

Architecture

graph LR
    Agent[Agent<br/>Amazon Bedrock Agents] -->|MCP tool calls| MCP[Continuum MCP Server<br/>AWS Lambda]
    MCP -->|SQL + vector search| DB[(CockroachDB Cloud<br/>3 regions)]
Loading

Three memory tiers, one cluster, four MCP tools: store_memory, recall_memory, list_episodes, forget_memory. Details in ARCHITECTURE.md.

Quickstart

git clone https://github.com/mittalpk/Continuum.git
cd Continuum
uv sync

# Point at a running CockroachDB cluster (see DEPLOYMENT.md for a real multi-region
# setup, or a single-node local instance for development, per CONTRIBUTING.md)
export DATABASE_URL="postgresql://root@localhost:26257/continuum?sslmode=disable"
export MCP_CONTINUUM_EMBEDDING_MODEL="amazon.titan-embed-text-v2:0"

cockroach sql --url "$DATABASE_URL" -f infra/sql/schema.sql   # applies SRS.md §6's schema
uv run uvicorn continuum.server:app --host 127.0.0.1 --port 8000

Point any MCP client (Claude Desktop, the MCP Inspector, or the Bedrock reference agent once deployed) at the running server. docs/api/mcp-tools.md has the full tool reference with examples. src/continuum/agent.py is a local reference-agent harness exercising the same tools end to end without needing a real MCP client; see tests/integration/test_agent.py for it in action.

Documentation

Document What it covers
SRS.md Requirements, acceptance criteria, non-functional targets
ARCHITECTURE.md Component design, data model, request flow, trade-offs
docs/adr/ Why the load-bearing decisions were made
docs/api/mcp-tools.md MCP tool reference with examples
DEPLOYMENT.md Provisioning the cluster, Lambda, and reference agent
RUNBOOK.md Operating a deployed system: multi-region checks, rollback, incident response
SECURITY.md Threat model, secrets handling, disclosure policy
TESTING.md Test strategy and how to run the suite
CONTRIBUTING.md Dev setup, PR process
CODE_OF_CONDUCT.md Community standards
CHANGELOG.md Version history

Status

All four MCP tools (store_memory, recall_memory, list_episodes, forget_memory) are implemented and tested against a live multi-region CockroachDB cluster, along with a local reference-agent harness proving FR-5's cross-session recall and NFR-PORT-01's generic-MCP-client requirement with a real client, not an in-process shortcut. Real Terraform exists for the Lambda deployment; an actual terraform apply and Bedrock Agents registration are pending AWS account access, tracked honestly rather than assumed done. See SRS.md §13 for what's deliberately left out of this version, and SRS.md §14 for the build timeline.

License

MIT

About

Continuum is an agentic memory layer for MCP-compatible AI agents, providing tiered working, episodic, and semantic memory on a multi-region CockroachDB cluster configured for REGION-level failure survival. Built for the CockroachDB × AWS "Build with Agentic Memory" hackathon.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages