state-trace

一个本地 MCP 服务器，为编码代理提供有容量上限的工作记忆图，含类型化节点与「当前/过期」状态，底层为 SQLite 或 JSON 文件。

可以做什么

以类型化节点形式存储和检索工作记忆条目，形成持久化图，让助手在编码会话中保留上下文，而不是每轮重新推导。记录记忆条目是当前有效还是已过期，帮助助手避免依据过时状态行动。按命名空间（例如仓库标识）限定读写范围，未设置命名空间的节点对所有命名空间可见。将记忆控制在可配置的容量预算内，并可选择 SQLite 或 JSON 文件作为存储后端。

适用场景

当你希望编码代理在会话中或跨仓库保留结构化、持久的工作记忆，并能区分新鲜状态与过期状态，而不必每次重新构建上下文时，适合安装。

运行要求

以本地 stdio 进程运行，从 PyPI 包 state-trace 安装，需要 Python 环境。可选环境变量：STATE_TRACE_STORAGE_PATH 指定 SQLite 或 JSON 存储文件（默认位于用户主目录下），STATE_TRACE_NAMESPACE 限定读写范围，STATE_TRACE_CAPACITY_LIMIT 设定记忆预算（默认 256）。未声明身份验证。