TradeMemory Protocol
官方面向MT5/外汇的AI交易记忆层,包含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 在 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 等人 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。仅供教育/研究用途。不构成财务建议。