Real-Time Stock Market Data for OpenCode如何为 OpenCode 接入实时股票市场数据

OpenCode 可以推理、记忆上下文、安排任务并调用工具，但语言模型的训练数据并不是实时行情源。接入市场数据可以补上新鲜度缺口，用于研究摘要、自选股检查、波动预警、看板原型和数据质量排查。

边界同样重要：本场景只为分析提供证据，并不授权交易。报价可能存在延迟、限定交易场所、采用综合行情、经过复权，或受到合同限制。因此，“实时”应当是数据源与订阅方案明确说明的属性，而不是根据一个看似最新的数字推断出来的标签。

为什么不把 WebSocket 直接送入模型？

持续数据流属于应用状态，不属于对话上下文。应由流消费者处理重连、排序、去重、背压和缓存更新，再由 OpenCode 通过工具获取有边界的快照或聚合结果。这样既能控制 token 消耗，也便于复现每次调用。

1. 选择服务商前先定义新鲜度

先明确资产类别、交易所、需要成交还是报价数据、可接受的最大数据年龄、盘前盘后处理方式、历史深度，以及结果是否会被展示或再分发。之后再比较服务商文档与数据权限；开发者方案与付费生产方案可能提供不同的数据源。

2. 构建与服务商无关的适配器

把服务商字段映射为统一的类型化契约，规范股票代码、时间戳、币种、交易时段、公司行为复权规则和类型化错误。服务商特有字段应放入可选的元数据对象。

3. 只暴露范围明确的读取工具

先提供 get_quote、get_bars 和 get_market_status 等操作，并限制股票数量、日期范围、时间粒度和响应大小。不要暴露任意 URL、任意 SQL 或服务商管理接口。

4. 在 OpenCode 中注册 MCP 服务

OpenCode 支持通过 stdio 连接本地 MCP 服务，也支持通过 Streamable HTTP 连接远程服务。在 OpenCode V2 中，应把唯一服务名配置在 mcp.servers 下。行情密钥应保存在环境变量中，不能写入提示词或代码仓库。若远程服务仅使用 API key，请将 oauth 设为 false，并通过受限请求头传递凭据。当前配置结构以 OpenCode 官方 MCP 文档为准。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "market-data": {
        "type": "local",
        "command": ["node", "./tools/market-data-mcp.mjs"],
        "environment": {
          "MARKET_DATA_API_KEY": "{env:MARKET_DATA_API_KEY}"
        },
        "codemode": true,
        "timeout": 10000
      }
    }
  }
}

除非 disabled 为 true，OpenCode 会自动连接已配置服务。通常应保留 codemode，并通过权限规则拒绝只读范围之外的操作。最后运行 opencode2 mcp list 检查连接状态。

5. 要求证据，而不是自信语气

要求 OpenCode 明确说明股票代码、数值类型、事件时间、接收时间、服务商/数据源、交易时段、币种和延迟分类。如果数据过期或市场休市，应先说明状态，再解释价格变化。

6. 测试降级状态

确定性测试使用录制样例，再执行主动启用的实时冒烟测试。需要覆盖限流、服务商超时、异常数据包、代码不存在、休市、缓存过期、批量结果不完整以及重连恢复。