The project operating system for AI agents.
MemoryBase gives your AI coding assistants a shared memory and task system. Agents read your project blueprint, update task statuses, record decisions, and coordinate with each other — all through a standardised MCP interface.
- 17 MCP tools — projects, blueprints, tasks, vault — works with Claude Code, Cursor, and any MCP-compatible client
- Real-time Kanban board — drag-and-drop tasks, live updates via Server-Sent Events when agents make changes
- Blueprint editor — structured project definition with in-place editing (tech stack, folder layout, API specs, constraints)
- Vault explorer — searchable, filterable log of decisions, error patterns, and architectural notes
- Zero-config defaults — SQLite out of the box; PostgreSQL for production
- Single Docker image — frontend and backend ship together
pip install memorybase
memorybase --port 8000Open http://localhost:8000 — that's it.
# 1. Run MemoryBase
docker run -p 8000:8000 \
-v $(pwd)/data:/app/data \
-e MEMORYBASE_API_KEY=my-secret-key \
ghcr.io/sabbiramin113008/memorybase:latest
# 2. Open in browser
open http://localhost:8000That's it. SQLite data is persisted in ./data.
# Clone
git clone https://github.com/sabbiramin113008/memorybase.git
cd memorybase
# Start backend (creates venv, installs deps, starts with --reload)
./start-backend.sh
# In a second terminal — start frontend dev server
./start-frontend.sh- Backend: http://localhost:8000
- Frontend: http://localhost:5273
- API Docs: http://localhost:8000/docs
Connect any MCP-compatible AI agent to MemoryBase:
Add to claude_desktop_config.json:
{
"mcpServers": {
"memorybase": {
"type": "sse",
"url": "http://localhost:8000/mcp/sse"
}
}
}Add to .cursor/mcp.json:
{
"mcpServers": {
"memorybase": {
"url": "http://localhost:8000/mcp/sse"
}
}
}Your agent can now call tools like list_projects(), get_blueprint(), create_task(), update_task_status(), add_vault_entry(), and more. See MCP Tools Reference.
Kanban board screenshot — coming soon
| Layer | Technology |
|---|---|
| Backend | Python 3.11, FastAPI, SQLModel, SQLite / PostgreSQL |
| Real-time | Server-Sent Events (sse-starlette) |
| Agent Protocol | MCP (FastMCP) |
| Frontend | React 18, Vite, Tailwind CSS v3, shadcn/ui |
| State | React Query, Zustand |
| Routing | React Router v6 |
| Drag & Drop | @dnd-kit/core |
| Docs | MkDocs Material |
memorybase/
├── backend/ # FastAPI app, SQLModel models, MCP tools, routers
├── frontend/ # React + Vite + Tailwind frontend
├── docs/ # MkDocs documentation source
├── tests/ # pytest smoke tests
├── Dockerfile # Multi-stage build (node → python)
├── docker-compose.yml
├── start-backend.sh # Dev convenience script
└── start-frontend.sh # Dev convenience script
See CONTRIBUTING for dev setup, project structure, and how to add new MCP tools.
MIT © sabbiramin113008