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）。未宣告身分驗證。