tradememory-protocol 接入实操:给 AI 交易代理装一套亏损记忆和下单刹车(20 个工具实测)
一句话说清它是干什么的
让 AI 交易代理「记住亏损的代价」。tradememory-protocol 是 mnemox-ai 开源的一个 MCP 服务器(GitHub 1400+ star,PyPI 包同名,当前版本 0.5.6),官方 README 的自我介绍第一句就是:「TradeMemory remembers what it cost.」它把你的成交流水同步进本地库,找出你自己历史上在哪儿亏钱,在下一次下单前把这些亏损单摆到代理眼前,并且能按你定的规则在订单到达券商之前拦下违规的那一笔。
背景值得知道:README 引用了 StockBrokers 2026 年 9 月 30 日的调研——现在多家券商允许 AI 代理经 MCP 下单,但护栏全是写死的数字上限(Webull 和 tastytrade 限制规模或购买力,盈透只让代理起草订单由你提交,Robinhood 和 Public 对外部代理没有任何可设上限),没有一家会参考你自己的历史交易表现。这个项目补的就是这个空档。(本文属于 AI 工具实操系列。)
先说清边界:默认形态是「记忆服务器」,官方安全声明原话是「Never places orders and never asks for broker keys. Records and recalls only」——不下单、不要券商密钥,只记录和召回。带刹车功能的 proxy 形态后面单独讲。
安装与接入
Python 3.10 及以上(PyPI 元数据 requires_python ≥3.10),一行装好:
pip install tradememory-protocol
Claude Desktop 的 claude_desktop_config.json 加这段(uvx 免安装直跑):
{
"mcpServers": {
"tradememory": {
"command": "uvx",
"args": ["tradememory-protocol"]
}
}
}
Claude Code 用户一行命令;不确定自己的客户端怎么配,跑 tradememory config 会按平台打印精确片段,还附带检测本机装了什么:
claude mcp add tradememory -- uvx tradememory-protocol # 或从源码跑 git clone https://github.com/mnemox-ai/tradememory-protocol.git cd tradememory-protocol && pip install -e . && python -m tradememory
重启客户端后它就在了。首次启动 stderr 会提示一句「First time? Run: tradememory setup」——交互式初始化向导,跑不跑都行,不跑也能直接用工具。
同步你的交易历史
记忆要有料才有用。官方给了两条零门槛起步路线:
# Hyperliquid:公开成交流水,不需要任何密钥 tradememory sync hyperliquid --address 0xYourAddress # Alpaca:只读调用,密钥放在本地文件里 tradememory sync alpaca --env-file ~/.secrets/alpaca.env
每笔已平仓交易只入库一次,重复跑只增量存新单。同步完它会直接打印你历史上亏钱的模式,README 给的输出样例长这样(数字为示意):
After 2 losses in a row (20 trades):
5 of them (25%) were 1.5x your usual size or more.
All 20 won 60% and made -$1,500.
The 5 sized-up trades won 20% and made -$1,700.
Median hold: winners 1.5h, losers 9.0h.
连亏两次之后的 20 笔交易里,5 笔加了仓的合计亏得比全部 20 笔还多——这就是它要在你下次想加仓时推到你眼前的记忆。MT5 和 Binance 现货的同步脚本在仓库 scripts/ 目录里。
20 个工具:五个组
Smithery 页面徽章写着 20 个 MCP 工具,本机 stdio 实测 tools/list 返回确认就是 20 个(serverInfo 报 tradememory-protocol 0.5.6,运行时框架 FastMCP 3.4.8),与 README 折叠表格的五组分类完全对上:

实测 tools/list 返回的 20 个工具:核心记忆 2 个、OWM 认知 6 个、风险治理 3 个、策略进化 5 个、审计 4 个
日常用得最多的就四五个。下单前问历史是 recall_memories,看当前状态是 get_agent_state,下单前检查够不够格是 check_trade_legitimacy,成交后记录是 remember_trade。官方 Getting Started 把这套流程整理成一份预检清单,原文照录:
Before every trade:
1. "What happened in similar conditions?"
2. "What's my current trading state?"
3. "Should I take this trade?"
→ The system returns: full size / reduced size / skip
After every trade:
4. "Record this trade with full context"
对应的 MCP 工具依次是 recall_memories → get_agent_state → check_trade_legitimacy → remember_trade。给 Claude 说人话就行,官方示例:「Record my AAPL long at $195 — earnings beat, institutional buying, high confidence.」一次调用,五层记忆自动更新(情景、语义、程序性、情感、审计)。
实测:三个工具的真实返回
在一台干净的 Linux 主机上装了 0.5.6 跑 stdio。先看 get_agent_state——空库时给的全是默认值:信心 0.5、风险偏好 1.0、净值 1 万美元、当前建议「normal」。这个默认净值不是你的真实账户,只是冷启动占位。
带参调 recall_memories(symbol=AAPL,market_context 写了财报周高波动),空库返回 matches_found: 0 加空的 memories 数组——结构完整,说明链路通,只是没记忆可召回。漏传参数再调一次,Pydantic 校验直接拦下:symbol 和 market_context 都是必填。这暴露了它的设计取向:召回必须绑定标的和行情语境,不存在「随便翻翻记忆」的调用方式。

冷启动状态、带参查询、缺参报错三段真实返回,输出逐字摘自本机 stdio 会话
想零成本看完整效果,官方给了个彩蛋命令:tradememory demo,无需任何 API key,模拟 30 笔 XAUUSD 交易跑通全流程。实际跑出来的结果很有说服力:模拟盘 30 笔总净赚 499.5 美元、胜率 63%,但拆开会话看——伦敦盘 14 笔全胜净赚 608.5,亚洲盘 10 笔只赢 1 笔净亏 156。系统据此生成三条策略调整:伦敦盘最大手数 0.05 放大到 0.08,亚洲盘砍半到 0.025,信心阈值 0.4 提到 0.55(低于 0.55 的交易在模拟里胜率为零)。同一个代理,有无这份记忆,下单行为完全不同。
刹车:proxy 形态(预览功能)
装 pip install "tradememory-protocol[proxy]"(要求 Python 3.12+)后,TradeMemory 能跑在你的代理和券商的 MCP 服务器(目前支持 Alpaca)中间:所有工具原样转发,只有下单类工具会先过一遍你自己的策略规则再决定放行或拒绝,每次评估无论放拒都记进审计日志。README 明说这是预览状态,且拒绝是默认姿势——不在标的清单内、超名义金额或仓位上限、进场不带保护性止损、当日亏损或回撤超限后开新仓、撤销持仓的保护性止损、刹车没分类过的工具,全部拒绝;唯一永远不拦的是平仓。
官方 2026-10-01 在真实 Alpaca paper 账户上做过端到端实测:三次拒绝(标的不在清单、进场无止损、名义金额超限)加一笔放行的单股带止损订单真实到达券商,还有一笔同 client_order_id 的重试从记录直接应答、没有二次下单。期权、改单、止损限价和追踪止损目前一律拒绝而非评估——宁可保守。
官方自己承认的边界
这个项目最难得的地方是 LIMITATIONS.md 写得极其坦白,开头就声明「README、演讲、论文与本文冲突时,以本文为准」。哪些验证过、哪些还是研究阶段,一张表说清:

官方 LIMITATIONS.md(2026-07-29 版)摘要:三项已验证组件,五项明确的现状限制
几条对使用决策影响最大的:五期严格验证(DQS 四层闸整合)官方自评「无效」,100 次实验 0/100 通过 DSR,回撤下降来自「没交易」而不是能力,校准层在重建;生产存储是单租户 SQLite,REST 服务只绑 127.0.0.1,无鉴权无限流,别直接暴露给多租户;券商直连今天只有 MetaTrader 5(轮询式),IBKR 和 Alpaca 在路线图上;审计链是「防篡改可见」而非「防篡改」——能重写整库的人能重建整条链。
还有一条小字但重要:进化类工具会读 Binance 公开行情,只有你设了 ANTHROPIC_API_KEY 才会调 Claude;每日审计根默认提交到社区运行的 freetsa.org 时间戳服务(只是 32 字节哈希、不含交易数据,设 TRADEMEMORY_TSA=off 可关)。项目声明「For educational and research purposes only. Not financial advice.」——研究用途,不构成投资建议,这句话应该刻在脑子里再用它。
来源与延伸
本文步骤、工具名与限制条款依据 tradememory-protocol 官方 README、Getting Started 与 LIMITATIONS.md 整理,实测输出摘自本机 Python 3.11 / pip 0.5.6 环境的 stdio 会话与 demo 命令,版权归原作者所有。