关于 headless-oracle
Headless Oracle 为需要确认交易所是否开市的自主交易 Agent 提供签名市场状态凭证。其故障关闭设计将未知状态视为闭市，凭证可独立验证。
主要功能
- 01提供签名市场状态凭证
- 02涵盖 28 个交易所的市场日程
- 03未知状态按闭市处理
- 04支持通过 REST 和离线方式验证凭证
- 05提供查询状态、日程、交易所及付款选项的 MCP 工具
适用场景
- 01交易前确认交易所是否开市
- 02独立验证市场状态凭证
MCP 相关
MCP 服务提供查询市场状态和日程、列出交易所以及查看付款选项的工具。凭证验证通过 REST 或离线工具进行，不属于 MCP 工具。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://headlessoracle.mmsebenzi-oracle.workers.dev/mcpclaude mcp add --transport http lembagang-headless-oracle https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp{"mcpServers":{"lembagang-headless-oracle":{"type":"http","url":"https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp"}}}在 Cursor 中打开{"servers":{"lembagang-headless-oracle":{"type":"http","url":"https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"lembagang-headless-oracle":{"type":"http","url":"https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp"}}}{"mcpServers":{"lembagang-headless-oracle":{"serverUrl":"https://headlessoracle.mmsebenzi-oracle.workers.dev/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mic | enum | 否 | ISO 10383 市场识别码。必填。示例：XNYS=NYSE、XNAS=NASDAQ、XLON=London、XJPX=Tokyo、XCBT=CME Futures、XCOI=Coinbase（全天候）、XBIN=Binance（全天候）。调用 list_exchanges 获取全部 28 个支持的代码。XNYS | XNAS | XLON | XJPX | XPAR | XHKG | XSES | XASX | XBOM | XNSE | XSHG | XSHE | XKRX | XJSE | XBSP | XSWX | XMIL | XIST | XSAU | XDFM | XNZE | XHEL | XSTO | XCBT | XNYM | XCBO | XCOI | XBIN |
详细介绍
Headless Oracle
面向 28 个全球交易所的 Ed25519 签名市场状态证明。
功能
自主交易 Agent 需要在执行交易前确认交易所是否开市。Headless Oracle 会提供经过加密签名的凭证来回答这个问题，任何 Agent 都可以独立验证，无需信任运营方。UNKNOWN 状态始终视为 CLOSED（故障时关闭）。
快速开始
# MCP (Claude Desktop, Cursor, any MCP client)
npx headless-oracle-mcp
# REST API — demo receipt (no auth required)
curl https://headlessoracle.com/v5/demo?mic=XNYS
# Sandbox key (200 calls, 7 days, no card) - POST with an email
curl -X POST https://headlessoracle.com/v5/sandbox \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]"}'
架构
单个 TypeScript Cloudflare Worker。使用 @noble/ed25519 进行 Ed25519 签名。三个 KV 命名空间（覆盖项、API 密钥、遥测）。两个 Durable Objects（webhook、SSE 流）。运行于 Cloudflare 边缘网络，无源站服务器。
四层故障关闭机制：KV 覆盖项检查 -> 日程引擎 -> UNKNOWN 回退 -> 未签名的严重故障。
完整架构请参阅 docs/architecture/overview.md。
API
四个 MCP 工具 - get_market_status、get_market_schedule、list_exchanges、
get_payment_options。凭证验证仅支持 REST（POST /v5/verify）或使用
@headlessoracle/verify 离线验证。
REST 接口以 OpenAPI 3.1 规范为准，该规范在线提供，并作为权威记录。完整参考文档：
交易所
23 个传统市场（XNYS、XNAS、XLON、XJPX、XPAR、XHKG、XSES、XASX、XBOM、XNSE、XSHG、XSHE、XKRX、XJSE、XBSP、XSWX、XMIL、XIST、XSAU、XDFM、XNZE、XHEL、XSTO），以及 5 个扩展市场（XCBT、XNYM、XCBO、XCOI、XBIN）。根据 IANA 时区名称自动处理夏令时。涵盖 2026-2027 年的午休、半日市和节假日。
测试
npm test # the full unit/integration suite
npm run test:smoke # 11 smoke tests against live production
通过测试的数量由 Worker 自行在
/v5/metrics/public 上发布为
tests_passing；如果该数字与测试套件结果不一致，CI 就会失败。此处不重复列出，
因为 README 中的数字没有任何检查机制。
安全
每个响应都带有 Ed25519 签名。凭证有效期为 60 秒。采用故障关闭架构（UNKNOWN = CLOSED）。所有响应均带有安全标头（HSTS、CSP、X-Content-Type-Options、X-Frame-Options）。
负责任披露政策请参阅 SECURITY.md。
文档
按受众分类的完整文档：
完整索引请参阅 docs/README.md。
许可证
MIT — 详见 LICENSE
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。