fxabsolute

本地服务

fxabsolute.com金融数据09 周前更新

代码仓库访问官网

关于 fxabsolute

fxabsolute 是供编码 Agent 使用的 MCP 服务，可查询 FXAbsolute 历史蜡烛数据，并连接交易者的实时图表。它提供数值 OHLC 和时段分析工具，无需从图表截图中识别数据。

主要功能

01支持 M1–W1 周期的 OHLC 蜡烛数据
02时段扫描与分组走势统计
03价格水平触及及反应分析
04实时图表配对与消息交换
05提供含绘图和交易的图表状态
06缓存并获取品种数据

适用场景

01分析交易时段中反复出现的蜡烛
02查看历史价格水平的反应
03通过 Agent 讨论回放中的图表
04查询图表数据而非解读截图

MCP 相关

MCP 服务提供历史蜡烛和时段分析工具，以及连接实时图表、接收交易者消息并在图表面板回复的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "varsansri-fxabsolute": {
      "command": "npx",
      "args": [
        "-y",
        "fxabsolute-mcp"
      ]
    }
  }
}

启动命令npx -y fxabsolute-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmfxabsolute-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

fxabsolute-mcp

通过 MCP 将编码 Agent 直接连接到 FXAbsolute 的蜡烛图历史数据。

这样做是为了不再让模型查看图表的图片。截图会迫使模型从像素中还原价格；这些工具直接提供数字，因此“纽约开盘时实际发生了什么”就成了一个查询，而不是猜测。

设置

无需安装，也不需要 API 密钥。服务会获取所需数据并将其缓存。

Claude Code

claude mcp add fxabsolute -- npx -y fxabsolute-mcp

Cursor、Windsurf、Claude Desktop，或任何读取配置文件的应用

{
  "mcpServers": {
    "fxabsolute": { "command": "npx", "args": ["-y", "fxabsolute-mcp"] }
  }
}

使用 claude mcp list 验证，或者直接问你的 Agent “fxabsolute 有哪些交易品种？”——它应回答共有十五种，并说明没有成交量数据。

在服务本身上进行开发

git clone https://github.com/varsansri/fxabsolute-mcp && cd fxabsolute-mcp
npm install
npm run smoke                # every tool against real data, ~30 checks
node test/proto.mjs          # stdio protocol round-trip
claude mcp add fxabsolute -- node "$PWD/src/index.js"

数据来源

按顺序：

FXA_DATA_DIR — 指向 .bin 文件的显式目录
../public/data — 在检出目录中运行时自动使用
FXA_ORIGIN（默认值为 https://www.fxabsolute.com）— 每种交易品种仅获取一次，并缓存在 ~/.cache/fxabsolute-mcp 下，因此可在任何机器上使用

每种交易品种约 38 MB，按需下载，且只下载一次。

工具

工具	可回答的问题
`fxa_instruments`	有哪些可用交易品种、包含多少根 K 线、有哪些字段
`fxa_candles`	任意 M1–W1 时间周期内某个日期范围的原始 OHLC 数据
`fxa_session_scan`	跨多个月份汇总交易时段内指定 K 线的数据
`fxa_bucket_stats`	按小时／星期几／月份／年份分组的波动情况
`fxa_level_touches`	某个价格水平是否实际守住，以及由此产生的反应

实时图表桥接

工具	用途
`fxa_connect_chart`	使用图表 AI 标签页中的代码与已打开的图表配对
`fxa_wait_for_message`	阻塞等待交易者输入或说话；返回其内容和图表状态
`fxa_reply`	在图表面板中回复
`fxa_set_thinking`	在长时间查询期间显示思考指示器
`fxa_disconnect_chart`	结束会话

交易者打开回测器，切换到 AI 标签页，并读出六位字符代码。其 Agent 调用 fxa_connect_chart，然后循环执行 fxa_wait_for_message → 回答 → fxa_reply。网站不存储 API 密钥，也无需支付推理费用——每位交易者都使用自己的 Agent。

每条消息都包含图表快照：交易品种、时间周期、回放位置、当前 K 线、每个绘图对象的真实几何信息（高度（点）、横跨的 K 线数量、每根 K 线的斜率、斐波那契水平、价格是否位于矩形框内）、未平仓交易和持续更新的绩效数据。Agent 读取的是数字，因此可以使用 fxa_session_scan 验证某个说法，而不必根据图像猜测。

传输方式采用 Supabase Realtime 广播通道，因此浏览器和 Agent 不必在同一台机器上——手机上的图表可以与笔记本电脑上的终端配对。凭据来自网站上的 /bridge-config.json，其中只有已存在于每位访客浏览器包中的可发布密钥，因此配对无需任何设置。

回放位置会随附说明，告知 Agent 不要透露交易者尚未看到的 K 线。如果助手泄露未来信息，回测就毫无意义。

促成本项目的查询——纽约时段每天的第一根 5 分钟 K 线，为期六个月——只需调用一次：

{ "instrument": "SPX500", "session": "nyse", "timeframe": "M5",
  "bars": [1], "from": "2024-01-01", "to": "2024-07-01" }

两件值得了解的事

没有成交量。 二进制格式中，每根 K 线占 20 字节：一个 uint32 时间戳，加上四个 float32 OHLC 值。从未存储过成交量，因此没有任何工具会报告成交量，也不会悄悄编造替代指标——改为提供 rangePips，并在每个相关响应中说明这一点。要添加真实成交量，就必须从 Dukascopy 重新获取全部约 543 MB 的数据，并使用更宽的记录格式。

时间周期按挂钟时间分桶，而不是按数组索引分桶。 浏览器图表每隔 N 根 K 线聚合一次，这适合逐根回放，却会导致分析结果偏移：外汇数据存在周末和节假日缺口，因此每组 60 根 M1 K 线中的第 N 组不再与真实时钟整点对齐，“H1 K 线”可能横跨周末。这里按 floor(ts / period) 对 K 线分桶，因此每根 K 线都落在真实边界上；存在缺口时不会生成合成 K 线。

交易时段窗口按交易所当地时间评估，并将夏令时精确处理到秒，因此“09:30 K 线”在 1 月和 7 月都是 09:30 的 K 线，不会每年春季偏移一小时。

fxa_session_scan 还会报告数据覆盖情况：窗口内有多少个工作日完全没有数据。这一点比听起来更重要——SPX500 在 2024 年上半年约有 19% 的工作日缺少数据；如果没有这项警告，对这段时间的扫描会返回看似正常的统计结果，但实际数据比你要求的少五分之一。

支持 Markdown

登录后评论