Tinydb Emcipi

🚀 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 工具（概述）

項目結構（頂級）

config/        配置文件與示例
logs/          運行時日誌
sandbox/db/    TinyDB JSON 數據庫
utils/         代碼模塊（數據庫、模式、MCP 包裝器）
main.py        入口點
docker-compose.yml
requirements.txt

貢獻指南

歡迎提交拉取請求！請遵循以下規則：

1. 遵循 PEP 8 規範，並保持導入語句有序。
2. 添加或更新單元測試。
3. 保持 README 和文檔字符串簡潔實用。

示例 MCP 提示

在 中提供了一個可用的 JSON 請求示例，展示瞭如何從 MCP 客戶端調用這些工具。

📄 許可證

© 2025 • MIT 許可證