跳至主要内容

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 工具沒有提供；只有上述七個工具。