适合谁
- 需要为 AI 交易代理引入持久记忆与决策审计的个人交易者。
- 需要在交易前查询历史情境的自主交易代理开发者。
- 需要可验证、可导出决策记录的合规或风控团队。
- 研究结果加权记忆（OWM）框架的研究人员。
T
69FMRS · C
TradeMemory Protocol 是一个自托管、MIT 许可的 MCP 记忆层，用 20 个工具为 AI 交易代理补齐「记忆」与「审计」两块能力：结果加权的历史召回、五层记忆写入、行为与风险分析，以及 SHA-256 前向链接、按日 Merkle 根的防篡改审计链。它明确不执行交易也不接触资金，主打本地优先，唯一外呼是每日审计根的可信时间戳（可关闭）。项目已进入维护模式，且审计链成熟度、OWM 经验验证和演化引擎均标注为尚未完成或研究阶段，适合重视决策留痕与复盘纪律的个人与团队，不适合期望托管服务、交易执行或投资建议的用户。
TradeMemory Protocol 是 AI 交易代理的「记忆层」：它不执行交易、不触碰资金，只负责记录和召回。交易前的召回会按结果质量、情境相似度、新鲜度、信心与情绪状态加权；交易后一次 remember_trade 调用即可写入情景、语义、程序、情感与交易记录五层记忆。每条决策在创建时即做 SHA-256 哈希并前向链接成审计账本，按 UTC 日汇总 Merkle 根，可通过 RFC 3161 可信时间戳对外锚定（默认开启，可用 TRADEMEMORY_TSA=off 关闭）。项目提供 20 个 MCP 工具与 35+ REST 端点，支持股票、外汇、加密货币、期货等任意市场与经纪商，本地优先，MIT 许可。项目自 2026 年 8 月起进入维护模式，仅处理缺陷与安全报告，不计划新增功能或托管服务。
工具能力
remember_trade
记录一笔交易，同时写入五层记忆结构。
recall_memories
按结果加权评分检索历史交易记忆。
get_agent_state
读取代理状态，包括信心、回撤与连亏连胜情况。
get_behavioral_analysis
分析行为模式与行为漂移。
create_trading_plan
创建带条件触发器的前瞻性交易计划。
check_active_plans
检查当前生效中的交易计划。
check_trade_legitimacy
五因子交易前门控，返回 full / reduced / skip。
export_audit_trail
批量导出审计链用于复核或监管提交。
verify_audit_hash
校验单条记录的 SHA-256 哈希是否被篡改。
verify_audit_chain
端到端校验整条链或某一段区间。
get_daily_root
获取某个 UTC 日期所有决策记录的 Merkle 根。
get_strategy_performance
查询策略表现统计。
get_trade_reflection
获取交易复盘反思内容。
validate_strategy
对策略进行统计验证。
compute_dqs
计算 DSR/MBL 等统计验证指标。
evolution_fetch_market_data
为演化引擎抓取市场数据。
evolution_discover_patterns
在数据中发现模式（研究阶段）。
evolution_run_backtest
运行策略回测（研究阶段）。
evolution_evolve_strategy
演化生成策略（研究阶段）。
evolution_get_log
读取演化过程日志。
安装接入
- 运行 pip install tradememory-protocol。2. 在 Claude Desktop 的 claude_desktop_config.json 中加入 mcpServers 配置，command 为 uvx，args 为 ["tradememory-protocol"]。3. 重启客户端后即可让代理记录交易。其他方式：Claude Code 执行 claude mcp add tradememory -- uvx tradememory-protocol；从源码安装则 git clone 仓库后 pip install -e . 并 python -m tradememory；也可用 docker compose up -d。
claude_desktop_config.json
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
选型与风险
不适合谁
- 期望 MCP 服务器代下订单、管理资金或接触钱包的用户——它不执行交易。
- 需要丰富官方托管服务或持续新功能迭代的团队（项目已进入维护模式）。
- 把其输出当作交易信号或投资建议的用户。
- 要求已具备 TSA 外部锚定、zkML 推理证明等尚未发布能力的用户。
所需权限
- 读取代理传入的交易决策上下文与交易记录。
- 在本地写入并维护记忆层与审计链数据。
- 默认向 RFC 3161 可信时间戳服务发起外呼，仅发送每日审计根的 32 字节哈希，不含交易数据；可用 TRADEMEMORY_TSA=off 关闭。
- 不访问 API 密钥、钱包或经纪商凭证。
风险与副作用
- 审计链的完整成熟度有限：v0.5 尚未包含 TSA 时间戳与外部锚定等能力（文档明确列为后续路线）。
- OWM 的经验验证仍在进行中（n=40，目标 n>=100 才具统计显著性），结论应谨慎对待。
- 演化引擎处于研究阶段，统计门控通过率仍在优化。
- 默认开启的外呼时间戳功能会向第三方服务发起网络请求，对完全离线的环境需手动关闭。
- 记忆与审计数据存于本地，本地磁盘被篡改或丢失会影响可验证性与历史留存。
常见排障
- 配置后客户端看不到工具：确认 uvx 在 PATH 中可用，或改用 pip install -e . 后 python -m tradememory 的方式启动。
- 需要完全离线运行时设置环境变量 TRADEMEMORY_TSA=off 以关闭时间戳外呼。
- 若 verify_audit_hash 或 verify_audit_chain 返回未通过，查看 first_break_at 定位链条断点并核对对应记录是否被修改。
- MT5 同步异常时参照文档的 MT5_SYNC_SETUP 检查连接与导出配置。
- N 较小或缺乏嵌入配置时，召回为 OWM-only 模式，需配置嵌入后才能启用向量融合。
使用场景
美股交易者在每次建仓前做盘前检查清单，先回忆相似情境下的历史结果。
外汇 EA 系统从 MT5 自动同步，记录被拦截的信号原因而不仅是已执行的信号。
合规团队使用 SHA-256 防篡改记录满足 MiFID II 与 EU AI Act 的日志要求。
用回顾式复盘检测行为漂移、策略衰减与常见交易失误。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持