eodrecord

eodrecord

eodrecord 为 Agent 提供一个读取窗口，用于查看基于规则的指数模型所发布的记录。该模型跟踪 SPY 和 QQQ；每个收盘时持有的资产及其配置情况都会作为每日收盘记录发布。该记录的免费视图比实时记录延迟 90 天，而这个软件包就是 Agent 读取记录的方式：包括延迟记录本身、每个已发布字段背后的固定定义、用于核验记录事后未被改写的账本指纹，以及指向当前已发布状态的指针。

此软件包本身不保存任何模型数据。它会在本地回答工具列表，内容与从实时端点捕获的内容完全一致；并将每次工具调用转发至上游，不作改动地返回结果。全部四种工具都是对已发布材料的只读视图。它们均不会购买、订阅、生成密钥，也不会向任何地方发送任何内容。

工具

• get_public_record — 已发布的每日收盘模型状态和配置变更，延迟 90 天显示（数据来自供应商的公开记录页面）。仅返回已发布的状态；不会重新计算。可选参数：days，整数，范围为 1 到 260，用于指定要返回最近多少个交易日的数据（默认值为 30）。无需提供参数。
• get_definitions — 每个已发布字段的固定定义：市场状态、配置状态、延伸度、距下一信号的距离和信号，以及发布时间表。无需参数。
• get_verification — 最新的公开账本指纹及其 RFC 3161 和 OpenTimestamps 收据，以及如何独立核验记录。无需参数。
• get_current_state — 当前已发布状态的位置。Core 成员会在状态发布当晚收到它；未提供密钥时，此工具会返回 Core 访问方式以及延迟公开记录的位置。无需参数。

配置

• TIDELINE_MCP_URL（可选）— 覆盖上游端点。默认值为 https://tideline.jbpscapital.com/mcp。（此覆盖入口是本次重建自行标注的还原。）
• TIDELINE_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头，使用调用者自己的密钥。未设置时，不会发送密钥标头。（标头名称由原始项目的注册记录确定；该记录声明了一个非必填的 Authorization 机密标头，但没有指定软件包环境变量名称。因此，环境变量名称和 Bearer 转发均为标注的还原——捕获原始接口时未使用密钥。）

转发机制

首次调用工具时，客户端会在上游开启一个可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 为 2025-03-26，clientInfo 名称为 eodrecord），然后发送 notifications/initialized 通知，最后发送携带调用者原样参数的 tools/call 请求。上游通过 initialize 响应返回 Mcp-Session-Id 标头时，该值会随会话中的所有后续请求发送；此会话会在进程的整个生命周期内复用。响应可以是纯 JSON，也可以是服务器发送事件；两种格式都会读取。

成功的上游结果会逐字传递，包括上游设置的任何 isError 标志。对于失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或无法完成的请求——会返回一个 isError 结果，其文本以 eodrecord error: 开头（此错误呈现方式是本次重建自行标注的还原）。

CLI

每个工具也可作为子命令使用，并接收一个 JSON 参数字符串：

npx @reneturcios/eodrecord get_public_record '{"days":30}'
npx @reneturcios/eodrecord get_definitions
npx @reneturcios/eodrecord get_verification
npx @reneturcios/eodrecord get_current_state
npx @reneturcios/eodrecord --version

退出代码：成功时为 0，结果包含 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/eodrecord mcp

MCP 客户端配置：

{
  "mcpServers": {
    "eodrecord": {
      "command": "npx",
      "args": ["-y", "@reneturcios/eodrecord", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/eodrecord
docker run --rm ghcr.io/cloudcorprecords/eodrecord --version

容器的默认命令为 mcp，因此第一种形式是 stdio MCP 服务；其他参数都会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过模拟的 JSON-RPC 上游运行，不会发起任何实时网络调用。

License

MIT — see LICENSE.