agent-trading-journal

Agent Trading Journal：面向 Claude Code 和 Codex 的 AI 交易日志（MCP 服务）

兼容： Claude Code · Codex CLI · Claude Desktop · Cursor · Windsurf · 任意 MCP 客户端 — 市场： 外汇、期货、股票、加密货币 — 导入： MetaTrader 4/5、TradingView、IBKR、NinjaTrader、Tradovate 等

由 AI Agent 为你填写的交易日志。 将图表截图粘贴到 Claude Code、Codex 或任意 MCP 客户端中。Agent 会读取截图，填写符合你自己的策略的字段，根据你的规则检查交易，记录交易并附上图片。本地仪表板会展示哪些做法有效。

无需表单、无需 LLM API 密钥、无需账户。所有数据都保存在你设备上的一个 SQLite 文件中。

_{包含生成的演示数据的仪表板（npx agent-trading-journal demo）。并非真实账户。}

为什么要开发这个工具

大多数“AI 交易日志”都只是网页表单加上一个事后读取你数据的聊天机器人。由此带来两个问题：

1. 记录交易是瓶颈。 手动录入交易很繁琐，因此人们会停止写交易日志。
2. 通用字段无法衡量具体情况。 “策略：A/B/C”无法告诉你自己的规则是否有效。

在这里，Agent 负责录入数据，而日志的结构则根据一场关于你如何交易的引导式访谈来定制：

	典型 AI 交易日志	Agent Trading Journal
谁录入交易	你通过表单录入	Agent 根据截图（或券商对账单）录入
AI 如何接入	应用使用你的 API 密钥调用 LLM	MCP：你的 Agent（Claude Code / Codex / …）就是 AI
衡量什么	固定字段 + 自由标签	根据你的策略定义的字段和规则清单
规则	备注	每条规则针对每笔交易标记为 pass/fail →“遵守规则与违反规则时的 E[R]”
跳过的策略	不跟踪	记录并复盘（当时不入场是否正确？）
风险限额	很少提供	类 prop firm 风控：每日亏损、最大回撤、每日交易次数、连续亏损次数

快速开始

1. 将其连接到你的 Agent。 需要 Node.js 22+。

Claude Code：

claude mcp add journal -- npx -y agent-trading-journal

Codex CLI（~/.codex/config.toml）：

[mcp_servers.journal]
command = "npx"
args = ["-y", "agent-trading-journal"]

Claude Desktop、Cursor 或其他 MCP 客户端：添加一个 stdio 服务，命令为 npx，参数为 ["-y", "agent-trading-journal"]。运行 npx agent-trading-journal setup 可查看所有配置片段。

2. 告诉你的 Agent： “设置我的交易日志。”

它会用你的语言采访你：市场、风险规则、如何判断方向偏好、策略、入场、止损和目标，以及何时不交易。根据你的回答，它会提出字段（每笔交易都要衡量的内容）和规则（你的入场清单）。你确认后，它就会保存。完整流程请参阅 docs/ONBOARDING.md。

3. 像往常一样交易或回测。 粘贴截图并说*“记录这笔交易”。也可以询问“每周复盘”或“盘前检查”。说“打开仪表板”*即可在 http://localhost:3777 查看。

只是想看看？运行 npx agent-trading-journal demo，即可填充单独的演示日志并打开仪表板。

Agent 能做什么（MCP 工具）

领域	工具
设置	get_setup_status、get_onboarding_guide、set_profile、list_presets、import_preset、upsert_strategy、get_strategy、list_strategies、export_strategy
账户与风险	upsert_account、list_accounts、check_risk
交易日志	start_session、list_sessions、log_trade、update_trade、delete_trade、query_trades、get_trade、add_screenshot
经验教训	add_lesson、update_lesson、delete_lesson、list_lessons
分析	get_stats、run_sql_readonly、export_review（Markdown，兼容 Obsidian）
导入	import_statement：MetaTrader 4/5、TradingView、IBKR、ThinkorSwim、NinjaTrader、Tradovate、TopstepX、Webull、DAS、TradeZella、Tradervue、通用 CSV
仪表板	start_dashboard、stop_dashboard、dashboard_status

MCP 提示词（支持提示词的客户端中的斜杠命令）：onboarding、log_trade_from_screenshot、weekly_review、pre_session_check。不支持提示词的客户端也可以通过 get_workflow 工具使用相同的工作流。

概念

• 策略：你的计划（方向判断、形态、入场、止损、目标、管理方式、不交易条件），以及：
  • 字段：你希望分析的每笔交易变量（enum、bool、number、text）。每个非文本字段都有自己的细分图表。
  • 规则：你的检查清单，每项规则均为 must 或 should。规则遵循情况会比较所有必选规则都得到遵循时与至少一项被违反时的预期收益。
  • 版本：字段或规则发生变化时，版本号会递增。旧交易保留其记录时对应的版本；移除的字段会归档，而非删除。
• 时段：在某个交易品种上的回测、前向测试或实盘交易时段，可选择关联到账户。
• R：以计划风险倍数表示的结果。统计数据基于 R，因此可在不同交易品种和账户规模之间进行比较。
• 预设：presets/ 中包含一个 入门 模板（适用于没有书面策略的交易者）、一个趋势回调策略和一个开盘区间突破策略。它们只是供你修改的起点，并非建议。
• 优势评分：开放的 0–100 综合评分（文档），交易少于 5 笔时不显示。

数据与配置

环境变量	默认值	用途
JOURNAL_DATA_DIR	~/.agent-trading-journal	包含 journal.db 和 screenshots/ 的文件夹
JOURNAL_DB、JOURNAL_SCREENSHOTS	数据目录内	覆盖任一路径
JOURNAL_PORT	3777	仪表板端口（仅绑定到 127.0.0.1）
JOURNAL_WEB	未设置	1 = 与 MCP 服务一同启动仪表板
JOURNAL_LOCALES_DIR	<data dir>/locales	额外的仪表板语言，格式为 <code>.json（文档）

复制数据目录即可备份。你可以查询 run_sql_readonly 和 SQLite 文件。

命令行

agent-trading-journal [mcp]            MCP server on stdio (what MCP clients run)
agent-trading-journal dashboard        dashboard at http://localhost:3777
agent-trading-journal demo             demo data in a separate dir + dashboard
agent-trading-journal import <file> --account <name> [--strategy <slug>] [--dry-run]
agent-trading-journal setup            config snippets for Claude Code / Claude Desktop / Codex

安全

这是一个交易日志与分析工具。它不会下单、连接经纪商执行交易，也不提供财务建议。杠杆交易风险很高。Agent 对图表的解读可能有误：每个记录的值都可查看和编辑，规则检查也会显示哪些规则未通过及其原因。

常见问题

我需要 OpenAI 或 Anthropic API 密钥吗？

不需要。该日志工具是一个 MCP 服务；AI 是你已在使用的 Agent（Claude Code、Codex、Claude Desktop、Cursor……）。日志工具本身从不调用大模型。

我的数据存储在哪里？会发送到网上吗？

所有数据都保存在一个本地 SQLite 文件和一个截图文件夹中（默认位置为 ~/.agent-trading-journal）。仪表板绑定到 127.0.0.1。日志工具不会将任何内容上传到任何地方。

我可以使用自己的交易策略吗？

这正是它的用途。引导访谈会将你的计划转化为自定义字段和规则检查清单。预设只是起点。SMC/ICT、价格行为、供需、指标、期权：任何你能描述的内容都适用。

我可以从 MetaTrader 5 或 TradingView 导入交易吗？

可以：import_statement（或 agent-trading-journal import <file> --account <name>）可读取 MT4/MT5 对账单、TradingView 模拟交易/策略导出文件，以及 IBKR、ThinkorSwim、NinjaTrader、Tradovate、TopstepX、Webull、DAS、TradeZella 和 Tradervue 的导出文件。随后，你的 Agent 可以为导入的交易添加截图和规则检查。

它支持回测（TradingView Replay）和自营交易公司挑战吗？

支持。交易时段可以是 backtest、forward 或 live。账户可以设置自营交易公司的限制（每日亏损、最大回撤、每日交易次数、连续亏损次数），而 check_risk 会在你触及限制前发出警告。

它会下单或提供信号吗？

不会。它只记录和分析交易。所有交易决策都由你做出。

致谢与许可证

MIT © 2026 smizxe。

对账单解析和往返重建使用了来自 LuxAlgo's Trade Journal 的 @luxalgo/journal-importers 和 @luxalgo/journal-core（MIT）。Edge Score 改编自其公开公式。本项目与 LuxAlgo 无关联，也未获其认可。