tinydb - emcipi MCP服务器 - 为聊天机器人集成本地化记忆存储，支持JSON处理

探索

Tinydb Emcipi

基于TinyDB的MCP服务器，为聊天机器人提供本地化长期记忆存储，支持JSON记录的存储、搜索和验证

数据库知识管理与记忆 #本地存储 #JSON数据库 #记忆管理 #MCP工具 .Python

评分 : 2分

下载量 : 4.8K

更新时间 : 2025-10-16

打开站点

什么是TinyDB-Emcipi?

TinyDB-Emcipi是一个Model Context Protocol (MCP)服务器，它使用TinyDB作为后端存储，为AI助手和聊天机器人提供长期记忆能力。通过简单的工具调用，AI可以存储、搜索和更新JSON格式的记录，只在需要时加载相关数据。

如何使用TinyDB-Emcipi?

您可以通过两种方式使用：本地安装Python依赖运行，或使用Docker一键部署。服务器启动后，AI助手就可以通过MCP协议调用各种数据库操作工具。

适用场景

适合需要持久化存储结构化数据的AI应用场景，如：用户偏好记忆、会话历史记录、知识库管理、小型项目的配置存储等。特别适合个人使用和小型项目。

主要功能

Docker友好部署

提供完整的Docker支持，只需一条命令即可启动服务，无需配置复杂的环境依赖。

Schema数据验证

所有存储的记录都会根据预定义的JSON Schema进行验证，确保数据的一致性和完整性。

完整的CRUD操作

提供创建、读取、更新、删除等完整的数据库操作工具，满足各种数据管理需求。

多数据库支持

支持创建和管理多个数据库，可以根据不同用途切换使用不同的数据存储。

灵活搜索功能

支持基于字段值的查询搜索，快速定位所需记录，提高数据检索效率。

优势

零外部依赖 - 基于纯Python实现，部署简单

轻量级设计 - 资源占用少，启动快速

本地存储 - 数据完全保存在本地，隐私安全

Schema优先 - 数据结构规范，易于维护

Docker支持 - 容器化部署，环境一致

局限性

单机部署 - 不支持分布式集群

性能限制 - 适合中小规模数据量

功能相对基础 - 缺少高级数据库特性

并发处理有限 - 不适合高并发场景

如何使用

环境准备

确保您的系统已安装Python 3.8+或Docker环境

选择部署方式

根据您的需求选择本地运行或Docker部署

本地运行（可选）

如果您选择本地运行，安装依赖并启动服务

Docker运行（可选）

如果您选择Docker部署，使用docker compose启动服务

连接AI助手

配置您的AI助手连接到MCP服务器端点：http://localhost:8000/mcp

使用案例

用户偏好记忆

AI助手可以记住用户的个人偏好设置，如语言偏好、主题设置、常用命令等

会话历史管理

存储重要的会话历史，帮助AI在后续对话中保持上下文连贯性

知识库构建

逐步构建个人或项目的知识库，存储重要信息和参考资料

常见问题

TinyDB-Emcipi适合存储大量数据吗？

数据存储在哪里？安全吗？

是否需要网络连接？

如何备份我的数据？

支持哪些类型的AI助手？

🚀 tinydb-emcipi

tinydb-emcipi 是一个基于 TinyDB 的 MCP 服务器，为聊天机器人和小上下文大语言模型应用程序提供即插即用的长期记忆功能，无需离开本地环境，且对 Docker 友好。

🚀 快速开始

原生方式

pip install -r requirements.txt
python -m main           # MCP 端点位于 http://localhost:8000/mcp

Docker Compose 方式

docker compose up        # 首次运行时构建依赖项

Compose 文件会将仓库挂载到 python:3.12-slim 容器内的 /app 目录，并启动相同的命令。

✨ 主要特性

零依赖：TinyDB 将 JSON 数据存储在磁盘上。
模式优先：每条记录都会经过验证，模式本身也可查询。
实用工具：提供列出数据库、切换数据库、内省模式、增删改查、搜索等工具。
Docker 友好：可通过单个 docker compose up 命令在本地或持续集成环境中运行。

📚 详细文档

可用的 MCP 工具（概述）

类别	工具	用途
发现	`create_database_tool`	创建新的数据库（可选择指定初始模式）
	`list_databases_tool`	查看所有 TinyDB 文件
	`switch_active_db_tool`	设置其他工具将使用的数据库
	`get_database_info_tool`	获取模式、示例记录、字段列表
记录	`search_records_tool`	字段值查询，同时返回模式
	`get_all_records_tool`	导出所有记录
	`add_record_tool` / `update_record_tool`	创建 / 修改经过验证的记录
模式	`set_schema_tool`	为数据库创建 / 更新 JSON 模式

项目结构（顶级）

config/        配置文件与示例
logs/          运行时日志
sandbox/db/    TinyDB JSON 数据库
utils/         代码模块（数据库、模式、MCP 包装器）
main.py        入口点
docker-compose.yml
requirements.txt