Skip to main content
Glama
ElSrJuez

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

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • CoreMemory-MCP

    michaelfeng
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides a local, persistent long-term memory service for MCP-compatible AI agents, enabling them to store, search, and recall information across sessions.
    1
    GPL 3.0

  • AI Memory MCP

    pateljeel123
    A
    license
    Not graded
    quality
    C
    maintenance
    A persistent, searchable memory layer for AI assistants, exposed as an MCP server. It supports CRUD, namespaces, hybrid ranked search, relationships, chat-context assembly, import/export, and optional LLM-powered auto-extraction.
    13 npm
    MIT

  • agenticmemory

    jyswee
    A
    license
    Not graded
    quality
    B
    maintenance
    Persistent memory MCP server for AI agents that stores, recalls, and searches conversation history, key-value context, and long-term entries across sessions with semantic search and FIFO queues.
    48 npm
    1
    -