跳到主要内容

AI agent（MCP）

API 也以 Model Context Protocol 提供于 https://data.cyberun.cloud/v2/mcp （streamable HTTP、无状态、JSON 响应）。agent 使用与你程序相同的密钥、权限与 限制。

Authorization: Bearer vmk_...

给 agent 独立密钥，才能在不影响其他人的情况下撤销。

工具​

工具用途
search_instruments依代号或名称、交易所、商品、种类与状态搜索目录
get_instrument单一商品的规格、数据集与范围
get_calendar某交易所的交易日与 UTC 时段，可限定商品
get_barsK 线，含连续合约的 diff 或 ratio
get_data多个商品与交易日的盘口快照，或时间点
create_export创建 Parquet 或 CSV 的批量导出
get_export导出工作的状态、文件与分区版本

工具调用与 HTTP 相同的 /v2 路由，响应字段相同。各工具的数据列上限与等待 时间见限制。用 cursor 续取，或改用 create_export。

答案太大时，工具回 {"code":"resource_exhausted"}，要求减少列数或改用导出。

Claude Code​

claude mcp add --transport http veinmesh https://data.cyberun.cloud/v2/mcp \
  --header "Authorization: Bearer $VEINMESH_API_KEY"

Cursor、Windsurf 等远程 MCP 用户端​

在用户端的 MCP 设置加入远程服务器：

{
  "mcpServers": {
    "veinmesh": {
      "url": "https://data.cyberun.cloud/v2/mcp",
      "headers": {"Authorization": "Bearer vmk_..."}
    }
  }
}

只支持本机服务器的用户端​

用 mcp-remote 桥接（例如 Claude Desktop）：

{
  "mcpServers": {
    "veinmesh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://data.cyberun.cloud/v2/mcp",
        "--header",
        "Authorization: Bearer vmk_..."
      ]
    }
  }
}

范例提示​

  • 「SHFE 有哪些螺纹钢期货合约？主力合约什么时候到期？」
  • 「给我 SHFE.rb2701 在 2026-10-19 与 2026-10-20 的 18 分钟 K 线，并解释成交量 最大的那根。」
  • 「比较 SHFE.rb.main 与 SHFE.rb.c1 最近五个交易日的日收盘。」
  • 「把这五个合约 2026 年 9 月的盘口快照导出成 Parquet。」

错误与等待​

工具失败时返回 problem JSON 文本，isError: true；错误码与 HTTP 相同。工具会 等待正在准备的交易日，之后回 data_pending；请 agent 重试。见错误。

v1 工具没有提供；只有上述七个工具。