Tinydb Emcipi

🚀 tinydb-emcipi

TinyDBをベースにしたMCPラッパーで、チャットボットにノートPC内での長期記憶機能を提供する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-emcipiを使用すると、エージェントはMCPツール呼び出しを通じてJSONレコードを保存、検索、変更でき、必要なものだけをロードすることができます。

• ゼロ依存 – TinyDBはJSONをディスクに保存します。
• スキーマ先行 – すべてのレコードが検証され、スキーマ自体もクエリ可能です。
• 独自のツール – データベースを一覧表示、切り替え、スキーマを調査、CRUD、検索ができます。
• Docker対応 – 単一のdocker compose upコマンドでローカルまたはCIで実行できます。

📦 インストール

ネイティブ環境

pip install -r requirements.txt

Docker Compose

docker compose up

💻 使用例

基本的な使用法

ネイティブ環境での起動:

pip install -r requirements.txt
python -m main           # MCPエンドポイントは http://localhost:8000/mcp

高度な使用法

Docker Composeを使用した起動:

docker compose up        # 初回実行時に依存関係をビルドします

📚 ドキュメント

利用可能なMCPツール (概要)

プロジェクト構造 (トップレベル)

config/        設定ファイルとサンプル
logs/          実行時ログ
sandbox/db/    TinyDBのJSONデータベース
utils/         コードモジュール (データベース、スキーマ、MCPラッパー)
main.py        エントリーポイント
docker-compose.yml
requirements.txt

MCPプロンプトの例

使用可能なJSONリクエストは、にあり、MCPクライアントからこれらのツールを呼び出す方法を示しています。

🔧 技術詳細

tinydb-emcipiは、TinyDBをバックエンドに持つTiny MCPサーバーです。これにより、チャットボットや小規模コンテキストのLLMアプリに長期記憶機能を提供します。TinyDBはJSONデータをディスクに保存するため、依存関係がゼロです。また、スキーマ先行のアプローチを採用しており、すべてのレコードが検証され、スキーマ自体もクエリ可能です。

🤝 コントリビューション

プルリクエストは大歓迎です！以下のことをお願いします。

1. PEP 8に従い、インポートをソートしてください。
2. ユニットテストを追加または更新してください。
3. READMEとdoc-stringを簡潔かつ有用なものに保ってください。

📄 ライセンス

© 2025 • MIT License