tinydb-emcipi

This repo is docker-friendly – an MCP wrapper around TinyDB that gives chatbots long-term memory without leaving your laptop.

Tiny MCP server backed by TinyDB — drop-in long-term memory for chatbots and small-context LLM apps.

Why?

Keeping structured facts in the prompt is wasteful. With tinydb-emcipi an agent can store, search and mutate JSON records through MCP tool calls, loading only what it needs.

• Zero dependencies – TinyDB stores JSON on disk.

• Schema-first – every record validated; the schema itself is queryable.

• Opinionated tools – list DBs, switch DB, introspect schema, CRUD, search.

• Docker-friendly – run locally or in CI with a single docker compose up.

Quick Start

Native

pip install -r requirements.txt
python -m main           # MCP endpoint on http://localhost:8000/mcp

Docker Compose

docker compose up        # builds dependencies at first run

The compose file mounts the repo into /app inside a python:3.12-slim container and starts the same command.

Available MCP Tools (summary)

Project Structure (top-level)

config/        configuration & sample
logs/          runtime logs
sandbox/db/    TinyDB JSON databases
utils/         code modules (db, schema, mcp wrappers)
main.py        entry-point
docker-compose.yml
requirements.txt

Contributing

Pull requests are welcome! Please:

1. Follow PEP 8 and keep imports sorted.

2. Add or update unit tests.

3. Keep the README and doc-strings concise and useful.

Example MCP Prompt

A ready-to-use JSON request lives at scratchpad/mcp.json.sample showing how to invoke these tools from an MCP client.

© 2025 • MIT License