TradeMemory Protocol
官方AI交易記憶層,適用於MT5/外匯,提供15個MCP工具——儲存/回顧交易、模式發現、策略演化及結果加權記憶。
你可以用 TradeMemory Protocol MCP 做什麼?
-
依情境回顧過往交易 — 在建立新倉位前,請助理依據結果品質、市場相似度、近期性、信心程度與情緒狀態,檢索先前的交易紀錄。
-
完整記錄交易脈絡 — 請助理記錄一筆已完成交易,連同其決策理由、市場條件與信心程度,並自動更新五層記憶。
-
執行交易前安全檢查 — 請助理依據五因子風險門檻評估潛在交易,並回傳完整、縮減或跳過之建議。
-
偵測行為偏移與連續虧損 — 要求分析您的交易模式,以從記憶中浮現信心趨勢、回撤警報與重複犯錯。
-
驗證稽核軌跡完整性 — 請助理使用 SHA-256 雜湊驗證,確認特定交易紀錄或整日交易鏈未被竄改。
-
匯出符合法規之紀錄 — 請助理產生交易決策紀錄的大量匯出檔案,以供監管審查或內部稽核提交。
文件
專案狀態(2026 年 8 月): 功能完整,處於維護模式 — 仍會審查錯誤與安全回報;不計劃新增功能或代管服務。付費工作請參閱交易記錄分析。
你的交易 AI 患有失憶症。而監管機構開始注意到了。
它每次交易時段都會犯下同樣的錯誤。它無法解釋為何交易。當上下文視窗結束時,它忘記一切。與此同時,MiFID II 正在提高演算法決策文件化的門檻(第 17 條)。歐盟 AI 法案要求對 AI 行為進行系統性記錄(第 14 條)。你競爭對手的代理程式正從每一筆交易中學習。
AI 交易技術堆疊缺少一層。每個 MCP 伺服器都處理執行 — 下單、取得報價、讀取圖表。沒有一個處理記憶。
你的代理程式可以買 100 股 AAPL,但無法回答:「上次我在這種條件下買 AAPL 時發生了什麼?」
TradeMemory 就是記憶層。 一個 pip install,你的 AI 代理程式就能記住每一筆交易、每一個結果、每一個錯誤 — 並附帶 SHA-256 防篡改稽核軌跡。
由一位獨立交易員在每次持倉前執行飛行前檢查清單所使用,也作為第一方系統對接 MT5 帳戶,記錄被阻擋的信號以及已執行的信號。請參閱 USE_CASES.md 以了解兩者的區別。
功能說明
- 交易前: 詢問你的記憶 — 上次在這種市場條件下發生了什麼?結果如何?
- 交易後: 一次呼叫記錄一切 — 五個記憶層自動更新
- 安全護欄: 信心追蹤、回撤警報、連敗偵測 — 系統會告訴你何時該停手
適用於任何市場(股票、外匯、加密貨幣、期貨)、任何經紀商、任何 AI 平台。TradeMemory 不執行交易,也不觸碰你的資金 — 它只負責記錄與回憶。
查看介面
tradememory-dashboard.onrender.com — 執行於示範性模擬資料集上的儀表板。無需安裝。
這是介面預覽,而非績效紀錄:交易為合成資料,且每個數字都標示為如此。若要了解記憶層在終端機中的實際作用,pip install tradememory-protocol && tradememory demo --fast 會重播 30 筆交易,並顯示從中推導出的回憶與參數調整。
快速入門
pip install tradememory-protocol
新增至 Claude Desktop(claude_desktop_config.json):
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
然後告訴 Claude:「記錄我的 AAPL 多單,價格 $195 — 財報優於預期、機構買盤、高信心。」
Claude Code / Cursor / Docker
# Claude Code
claude mcp add tradememory -- uvx tradememory-protocol
# From source
git clone https://github.com/mnemox-ai/tradememory-protocol.git
cd tradememory-protocol && pip install -e . && python -m tradememory
# Docker
docker compose up -d
完整逐步教學: 快速入門(交易員軌道 + 開發者軌道)
誰在使用 TradeMemory
| 美國股票交易員 | 外匯 EA 系統 | 合規團隊 | |
|---|---|---|---|
| 市場 | 股票(AAPL、TSLA、...) | XAUUSD(黃金) | 多資產 |
| 方式 | 每筆交易前的飛行前檢查清單 | 從 MT5 自動同步 | 完整決策稽核軌跡 |
| 核心價值 | 紀律系統 — 每個決策前的記憶 | 記錄信號被阻擋的原因,而不只是已執行的部分 | 供監管機構使用的 SHA-256 防篡改記錄 |
| 詳細資訊 | 了解更多 → | 了解更多 → | 了解更多 → |
運作方式
- 回憶 — 交易前,依結果品質、情境相似度、近期性、信心與情緒狀態加權檢索過往交易(OWM 框架)
- 記錄 — 交易後,一次呼叫
remember_trade寫入五個記憶層:情節記憶、語意記憶、程序記憶、情感記憶與交易記錄 - 反思 — 每日/每週/每月檢視偵測行為漂移、策略衰退與交易錯誤
- 稽核 — 每個決策在建立時即進行 SHA-256 雜湊。可隨時匯出供審查或監管提交
MCP 工具
| 類別 | 工具 | 說明 |
|---|---|---|
| 記憶 | remember_trade · recall_memories | 以結果加權評分記錄與回憶交易 |
| 狀態 | get_agent_state · get_behavioral_analysis | 信心、回撤、連敗、行為模式 |
| 規劃 | create_trading_plan · check_active_plans | 具條件觸發器的前瞻性計畫 |
| 風險 | check_trade_legitimacy | 5 因子交易前閘門(完整/減少/跳過) |
| 稽核 | export_audit_trail · verify_audit_hash | SHA-256 防篡改偵測 + 批次匯出 |
全部 20 個 MCP 工具 + REST API
| 類別 | 工具 |
|---|---|
| 核心記憶 | get_strategy_performance · get_trade_reflection |
| OWM 認知 | remember_trade · recall_memories · get_behavioral_analysis · get_agent_state · create_trading_plan · check_active_plans |
| 風險與治理 | check_trade_legitimacy · validate_strategy · compute_dqs |
| 演化 | evolution_fetch_market_data · evolution_discover_patterns · evolution_run_backtest · evolution_evolve_strategy · evolution_get_log |
| 稽核 | export_audit_trail · verify_audit_hash · verify_audit_chain · get_daily_root |
REST API: 35+ 個端點,涵蓋交易記錄、反思、風險、MT5 同步、OWM、演化與稽核。完整參考 →
交易記錄分析
TradeMemory 本身是免費且自架的。維護者提供的付費服務是對你自己的交易記錄進行統計分析:匯出你的 MT4/MT5 歷史記錄,即可獲得一份描述性統計報告 — 你的虧損集中在何處、虧損後你的部位規模如何變化、強制平倉結構,以及你每筆交易實際承擔的風險 — 隨後再進行一次逐步講解通話。
僅對過往交易進行描述性統計:不提供交易信號、不提供投資建議、不承諾績效。你的檔案會在交付後刪除。
企業與合規
你的代理程式所做的每個交易決策 — 包括不交易的決策 — 都會記錄為交易決策記錄(TDR)。每筆記錄的 SHA-256 內容雜湊會連結成前向鏈結的稽核帳本;每個 UTC 日以 Merkle 根摘要,而 Merkle 根本身又跨日鏈結。竄改任何歷史記錄都會使所有後續連結失效。
| 法規 | 要求 | TradeMemory 涵蓋範圍 |
|---|---|---|
| MiFID II 第 17 條 | 記錄每個演算法交易決策因子 | 完整決策鏈:條件、過濾器、指標、執行 |
| 歐盟 AI 法案第 14 條 | 高風險 AI 系統的人類監督 | 每個決策的可解釋推理 + 記憶脈絡 |
| 歐盟 AI 法案第 12 條 | 系統生命週期內自動、防篡改的日誌 | 鏈結 SHA-256 鏈 + 每日 Merkle 根(RFC 3161 TSA 於 Phase 1.5) |
# Verify a single record hasn't been tampered with
verify_audit_hash(trade_id="MT5-7047640363")
# → {"verified": true, "chain_entry": {"sequence_num": 42, ...}}
# Walk the entire chain (or a slice) end-to-end
verify_audit_chain(from_seq=1, to_seq=None)
# → {"verified": true, "checked_count": 1284, "first_break_at": null}
# Daily Merkle root — single 32-byte anchor over every TDR for that day
get_daily_root(date="2026-05-14")
# → {"verified": true, "root_hash": "a05544...", "record_count": 18}
# Bulk export for regulatory submission
GET /audit/export?strategy=VolBreakout&start=2026-03-01&format=jsonl
請參閱 LIMITATIONS.md 以取得完整的稽核鏈成熟度聲明,包括 v0.5.2 尚未包含的項目(TSA 時間戳、外部錨定、zkML 推理證明)。
需要為你的基金進行客製化部署? → dev@mnemox.ai
安全性
- 絕不觸碰 API 金鑰。 TradeMemory 不執行交易、不移動資金、不存取錢包。
- 僅讀取與記錄。 你的代理程式將決策脈絡傳遞給 TradeMemory。它負責儲存。僅此而已。
- 本地優先。 唯一的對外呼叫是對每日稽核根進行 RFC 3161 可信時間戳 — 一個 32 位元組的雜湊,不含任何交易資料(預設開啟;可使用
TRADEMEMORY_TSA=off停用)。其他任何資料都不會離開你的機器。 - SHA-256 鏈結稽核帳本。 每筆記錄在建立時即進行雜湊,並連結至前一筆記錄。每日 Merkle 根為鏈條提供錨定。可在記錄、區段或日層級驗證完整性。竄改在每個層級都可被偵測;外部錨定(預設為 TSA)已列入路線圖。
- 1,400+ 項測試通過。 完整測試套件搭配 CI。
研究狀態
TradeMemory 的 OWM 框架以認知科學(Tulving 1972)與強化學習(Schaul et al. 2015)為基礎。目前狀態:
- OWM 五因子評分: 已實作、已測試(1,400+ 項測試)
- 統計驗證: 已實作 DSR、MBL(Bailey-de Prado 2014)
- 稽核軌跡: SHA-256 防篡改 TDR
- 演化引擎: 研究階段(策略生成可用,統計閘門通過率待最佳化)
- 混合回憶: 僅 OWM 模式啟用,設定嵌入後可使用向量融合
- 實證驗證: 進行中(n=14 筆交易,目標 n>=100 以達統計顯著性;在 n=14 時信賴區間過寬,無法得出任何結論 — 請參閱 validation/final_verdict.md)
文件
| 文件 | 說明 |
|---|---|
| 快速入門 | 安裝 → 第一筆交易 → 飛行前檢查清單 |
| 使用案例 | 3 種使用情境,每種皆標示為第一方或獨立 |
| API 參考 | 所有 REST 端點 |
| OWM 框架 | 結果加權記憶理論 |
| 架構 | 系統設計與層級分離 |
| 教學 | 詳細逐步說明 |
| MT5 設定 | MetaTrader 5 整合 |
| 研究日誌 | 演化實驗與資料 |
| 失敗分類 | 11 種交易 AI 失敗模式 |
| 中文版 | 繁體中文 |
貢獻
MIT — 請參閱 LICENSE。僅供教育/研究用途。不構成財務建議。