toki-toki

Name: toki-toki
Author: xfloukiex-lab

本地服务

github.com/xfloukiex-lab记忆与知识019 周前更新

代码仓库

关于 toki-toki

Toki Toki no Mi 是一个 MCP 服务，在本地保存可搜索的决策、被否决的方案及其理由。它帮助团队和助手回顾过往依据，并发现与既有决策相冲突的提议。

主要功能

01记录决策及其理由
02保存被否决的方案
03按关键词搜索历史决策
04标记与既有决策的冲突
05以 SQLite 和 Markdown 保存

适用场景

01回想架构选择的原因
02在后续会话中查阅旧决策
03将新提议与记录的选择核对

MCP 相关

向 MCP 客户端提供记录决策和检索本地历史的工具，可检索全部记录或按关键词筛选。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "xfloukiex-lab-toki-toki": {
      "command": "uvx",
      "args": [
        "toki-toki-mcp"
      ]
    }
  }
}

启动命令uvx toki-toki-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypitoki-toki-mcp0.1.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

⏳ Toki Toki no Mi

一个会记住每个决策为何作出的 MCP 服务——本地、可搜索的决策日志。

一个模型上下文协议（MCP）服务——一个专注型工具，可接入兼容 MCP 的客户端（Claude Desktop、Claude Code、Cursor 等）。

功能

对话的上下文窗口会遗忘。几次会话后，某项架构选择背后的推理便会消失，你不得不重新讨论已经敲定的决策——或者在不知不觉中推翻它们。

Toki Toki no Mi 是一份因果账簿。它会记录每项决策、你否决的备选方案以及作出选择的原因，之后还可以让助手调取这些历史记录，并标记与过往决策相矛盾的新提案。

使用方法

两个工具：

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" }
  }
}

重启客户端后即可使用该工具。

Grand Line 技术栈

Toki Toki no Mi 是四工具套装的一部分。每个工具都可以独立使用，但全部安装后，就能通过 Laugh Tale 解锁最终惊喜。

	Package
🗿	`road-poneglyph`	Road Poneglyph
⚔️	`conquerors-haki`	Conqueror's 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