Skip to main content
Glama
Sign In
TinyDB MCP Server

TinyDB MCP Server

by ElSrJuez
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

tinydb-emcipi

tinydb-emcipi banner

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.

Related MCP server: CoreMemory-MCP

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)

Category

Tool

Purpose

Discovery

create_database_tool

create new DB (optionally with initial schema)

list_databases_tool

see all TinyDB files

switch_active_db_tool

set the DB every other tool will use

get_database_info_tool

schema, sample records, field list

Records

search_records_tool

field-value query, returns schema too

get_all_records_tool

dump every record

add_record_tool / update_record_tool

create / modify validated records

Schema

set_schema_tool

create / update JSON Schema for a DB

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

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers