toki-toki

⏳ Toki Toki no Mi

各決定がなぜなされたのかを記録する MCP サーバーです。ローカルで検索できる決定ログです。

Model Context Protocol（MCP）サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code、Cursor など）に接続する、特定の用途に特化したツールです。

機能

会話のコンテキストウィンドウは内容を忘れてしまいます。数回セッションを重ねると、アーキテクチャ上の選択をした理由が失われ、すでに決着した決定を再び議論したり、気づかないうちに覆したりすることになります。

Toki Toki no Mi は因果関係の台帳です。各決定と、却下した選択肢、選んだ理由を記録し、後からアシスタントがその履歴を取得できるようにします。また、新しい提案が過去の決定と矛盾する場合は、それを知らせます。

使い方

2 つのツールがあります。

• log_causality_point — 決定、却下した選択肢、正当化の理由を記録します
• time_leap_retrieval — 過去の決定を呼び出します（すべて、またはキーワードで絞り込み）

決定は ~/.grandline/ の下にある SQLite にローカル保存され、Markdown ファイルにもミラーリングされます。そのため、外部の検索ツールからこのフォルダーを参照できます。

ツールリファレンス： log_causality_point(decision_made, alternatives_rejected, justification) · time_leap_retrieval(query: str = "")

仕組み

自己完結型で、API キー不要、完全ローカルです。 台帳はマシン上の単一の SQLite ファイルで、外部依存関係はありません。データが外部に送信されることはありません。

インストール

Python 3.10 以降が必要です。

pip install toki-toki-mcp

これにより、toki-toki コマンドがインストールされます。

次に、MCP クライアントに登録します。claude mcp add toki-toki -- toki-toki を実行するか、クライアントの設定（例：claude_desktop_config.json）に以下を追加してください。

{
  "mcpServers": {
    "toki-toki": { "command": "toki-toki" }
  }
}

クライアントを再起動すると、ツールを利用できるようになります。

グランドラインのスタック

Toki Toki no Mi は、4 つのツールからなるセットの一部です。各ツールは単独で動作しますが、すべてをインストールすると、Laugh Tale を通じて最後のサプライズが解放されます。

	パッケージ
🗿	road-poneglyph	ロード・ポーネグリフ
⚔️	conquerors-haki	覇王色の覇気
⏳	toki-toki	Toki Toki no Mi · ← このリポジトリ
🏴‍☠️	laugh-tale	Laugh Tale

開発

git clone https://github.com/xfloukiex-lab/toki-toki
cd toki-toki
python -m venv .venv && . .venv/Scripts/activate   # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
python tests/test_toki_toki.py

クレジットとライセンス

Apache-2.0 ライセンスで公開されています。アイコンはオリジナルのアートワークです（icon.svg を参照）。ローカルで生成されており、リポジトリにはサードパーティのアセットは含まれていません。

これはファンの着想をもとにしたプロジェクトです。 One Piece （尾田栄一郎／集英社／東映アニメーション）の制作者または権利者との提携、支援、承認を受けていません。「One Piece」および関連する名称はテーマ上の表現としてのみ使用されており、それぞれの所有者に帰属します。