Agent Memory Server

A tiny MCP (Model Context Protocol) service backed by SQLite, with a co-located Starlette web dashboard.

Installation

py -m pip install -r requirements.txt
py -m pip install -e .

Usage

stdio transport (for MCP clients)

py -m agent_memory

HTTP dashboard + SSE MCP server

py src/agent_memory/main.py

Then open http://127.0.0.1:8765/dashboard in your browser.

The SSE MCP endpoint is mounted at /mcp.

Testing

py -m pytest tests/ -v

File layout

src/agent_memory/
  server.py          FastMCP tools + Starlette routes
  storage.py         SQLite wrapper
  __main__.py        stdio entrypoint
  main.py            Uvicorn runner
  templates/         Jinja2 HTML templates
  static/            CSS/JS assets
tests/
  test_storage.py
  test_server.py
  test_dashboard.py