面向 AI 智能体的加密 MCP 服务器

#将你的 AI 连接到加密货币 MCP 服务器

一个 URL 和一个请求头。服务器默认关闭：没有有效的 X-API-KEY 时，不会公布任何工具，所有请求都以 401 拒绝（缺少请求头时为 X-Deny-Reason: missing_api_key，密钥未知或已吊销时为 invalid_api_key）。

{
  "mcpServers": {
    "bytnode": {
      "type": "http",
      "url": "https://api.bytnode.com/mcp",
      "headers": { "X-API-KEY": "your_key" }
    }
  }
}

配置文件的具体格式取决于 AI 智能体，上面的通用代码块并不适用于所有客户端：Claude Desktop、ChatGPT 和 Gemini CLI 的读取方式不同。MCP 服务器页面为每个客户端提供可直接粘贴的配置：Claude Desktop、Claude Code、ChatGPT、Cursor、Codex、VS Code、LangChain、n8n 等。

传输为无会话的 Streamable HTTP：每个请求自成一体。serverInfo.version 为 MCP 接口的版本（1.0.0）——包括其工具、说明和响应形式——，与 API 契约的版本（1.0.2）不同；每个响应都会在 mcp_version 中重复它。有些客户端会保留连接时收到的工具定义：当 mcp_version 变化时（新的主版本表示需要适配的变更），请重新连接连接器以加载新的定义。能力声明只包含实际存在的内容——工具和资源，没有 listChanged 通知——未知资源返回 JSON-RPC 错误 -32002。/mcp 开放 CORS：在浏览器中运行的 MCP 客户端可以连接。通过 OAuth 登录的连接器（claude.ai、ChatGPT、Claude Code）无需密钥：不带密钥的请求会收到 401 以及 WWW-Authenticate: Bearer resource_metadata=…，它指向授权服务器 bytnode.com，您在那里批准连接。否则，密钥放在 X-API-KEY 请求头中，或作为 Authorization: Bearer 发送。 无需密钥，服务器卡片 https://api.bytnode.com/.well-known/mcp/server-card.json 描述了完整的接口（工具、资源、版本、认证方式），/mcp/server.json 是其在官方 MCP 注册表中的条目。

#十一个加密市场数据工具

十一个工具均为只读、无副作用且幂等：AI 智能体可以放心重放。五个数据工具各有一个目标——交易对、资产、全市场、宏观、链上——用法相同：fields（要返回的字段名）、limit、since_ms / until_ms、last、columns、detail 和 max_tokens（详见 get_pair_data）在每个工具中含义一致，每个响应都带有 server_time 和 response_tokens；它们的通用约定——模式、窗口、摘要、单位、大小预算——写在服务器的说明（instructions）中，连接时发送一次，而不是在每个描述中重复。rank_pairs 按一个指标为所有交易对排名，read_export 读取因预算被截断的响应的其余部分。

await c.call_tool("get_market_indicators", {
    "symbol": "BTCUSDT",
    "timeframe": "1h",
    "limit": 60,
    "indicators": [
        {"id": "rsi_7", "type": "rsi", "period": 7},
        {"id": "rsi_21", "type": "rsi", "period": 21},
        {"id": "macd", "type": "macd", "fast": 12, "slow": 26, "signal": 9},
        {"id": "adx_14", "type": "adx", "period": 14},
    ],
})

#加密市场数据的当前值或历史

模式只取决于一件事：是否提供日期窗口。没有 since_ms、until_ms 和 last 时，数据工具返回当前值；提供其中之一时，每个请求的字段都返回该窗口内的历史——一次调用即可获取多个带日期的指标。

#定位加密货币交易对与市场

每个数据工具都有自己的目标：get_pair_data 为交易对（symbol，必填），get_options_data 为资产（asset，必填），get_macro_data 为目录中的序列（series），get_market_overview 和 get_onchain_data 无需目标。每个字段只属于一个工具。不符合的请求会在首次网络调用之前被拒绝，绝不会被默默吞掉，并且所有问题都在同一条消息中列出。

#64 个加密市场字段

名称与 API 一致，当前值和历史使用同一名称，差异如下：整体市场在这里叫 global_market，在 REST 快照中叫 global（global 是 Python 的保留字，服务器用 Python 编写）；市场在这里是参数（market: "spot"），在 REST 中是路径后缀（/v1/cvd/spot）；每个期权到期日的数据通过 get_options_data 的 expiries: true 获取（REST：/v1/options/expiry），交易对的能力通过 symbol_capabilities 目录获取（REST：/v1/capabilities?symbol=…）；历史数据在 timeframe_applied 中说明工具采用的步长，因为工具可能自行选择。每个字段的详情——所属工具、包含什么、单位、N 的含义、上限、历史——由 describe_fields 给出；每个工具的描述为每个字段写一行，附带其标签（周期、仅当前值、live、limit 上限）。另见数据目录。

#响应：AI 智能体可读的加密市场数据

数据沿用 API 的名称、单位和约定，每个字段一个键，但会以面向AI 智能体的方式呈现，而不是原样返回。带周期的字段键名为 字段@tf；多个交易对时，每个键前加上其交易对（ETHUSDT/funding_next、BTCUSDT/cvd@1h）。响应总是包含 mode、data、api_requests、server_time（服务器时间，ISO 8601 UTC）、mcp_version（MCP 接口版本）和 response_tokens（响应自身的大小，以估算的 token 计），适用时还包含 scopes、summary、ranges、freshness、warnings、errors、partial、unavailable、omitted_columns、missing、truncation、export、timeframe_applied 和 window；get_market_indicators 和 rank_pairs 使用相同的外层结构。空的或不适用的序列为 null，unavailable 说明原因。unavailable 和 out_of_plan_fields 与快照中的相同。所有工具都不声明 outputSchema：各个键在本页说明，structuredContent 携带与文本相同的 JSON。

{
  "mode": "latest",
  "data": {
    "klines@1h": {
      "first_time": "2026-10-21T13:00:00.000Z",
      "step_s": -3600,
      "columns": ["open", "high", "low", "close", "volume"],
      "rows": [[…], …]
    },
    "oi@1h": { "first_time": …, "step_s": -3600, "columns": ["oi", "oi_usd", … ], "rows": [ … ] },
    "funding_next": { … },
    "price_change": { … }
  },
  "scopes": {
    "symbol:BTCUSDT": ["klines@1h", "oi@1h", "funding_next", "price_change"]
  },
  "summary": {
    "klines@1h": { "column": "close", "latest": …, "min": …, "max": …, "mean": …,
                   "change_pct": …, "high_max": …, "low_min": …, … }
  },
  "freshness": { "age_s": { "klines@1h": 4, "funding_next": 2, … }, "stale": [] },
  "omitted_columns": { "klines@1h": ["is_closed"] },
  "timeframe_applied": "1h",
  "unavailable": { … },
  "api_requests": 1,
  "server_time": "2026-10-21T14:02:31.512Z",
  "response_tokens": 1840
}

• data：行列表以 {columns, rows} 形式给出，行从新到旧排列；单个点以对象给出；空的或不适用的序列为 null。步长规则的序列没有 time 列，而是给出 first_time 和 step_s，无论行数多少，一行也是如此：第 i 行的时间为 first_time + i × step_s，step_s 为负数，从最新一行往前推；只要有任何缺口，就保留 time 列。事件（逐笔成交、逐笔清算）和表格保留其 time，所有行共有的部分只在块上说明一次：date（此时每个 time 为当天的 UTC 时间，如 12:54:30.494Z）或单个 time（所有行同一时刻，如到期日表）；没有任何行带毫秒时去掉 .000。浮点数保留 6 位有效数字，供应量和累计值除外，它们保留完整的整数单位。使用 detail: "compact"（默认）时，重型行只保留主要列，所有行都已收盘时去掉 is_closed，并去掉成交 ID；omitted_columns 说明省略了哪些列，detail: "full" 会返回它们。
• scopes：每个键的真实范围——symbol:X、asset:X、series:X，无目标的字段为 market。不带 series 请求的 macro 标记为 market，绝不会标记为某个序列。多个交易对时，键的前缀已标明其交易对：只保留其他目标的范围（market…）。
• mode：latest 或 history；历史模式下，window 会重复时间边界，ranges 按序列说明实际覆盖的范围：timeframe、row_count、from 和 to（第一个和最后一个时间桶的起点，与每行的 time 相同）、note 和 truncated；序列被截断时，missing 说明如何获取其余部分——更小的 limit、以 next_until_ms 结束的更早窗口，或从其给出的 offset 开始调用 read_export。
• summary：按序列在其主列上给出最新值和最早值、最小值和最大值及其时间、平均值；流量类（清算、净成交量…）给出总和，并在 sums 中给出各组成部分之和（long_usd 与 short_usd、buy_volume 与 sell_volume），状态类给出变化量（有意义时还有 change_pct）；K 线另给出 high_max 和 low_min 及其时间。逐笔成交和逐笔清算另给出 by_side（每一方的笔数、数量和美元金额）。
• freshness（当前值）：来自数据流监控，age_s 给出每个键的源数据流距上次送达已过去多少秒（一行数据的日期是其 time），stale 列出数据流滞后的键；warnings 列出每个滞后的字段（其值并非当前值），以及被某个字段忽略的每个投影列。
• 大小：每个响应默认上限为估算的 6,000 个 token；数据工具、get_market_indicators、rank_pairs 和 read_export 的 max_tokens 参数可将其设为 1,500 到 16,000，response_tokens 给出每个响应的大小。超出预算时，最重的序列保留最新的行，截断情况只说明一次，写在每个序列的 ranges 中（total_row_count 行中返回了 row_count 行；missing 说明如何获取其余部分，通常给出足以容纳完整响应的 max_tokens；多个交易对的同一字段被截断时，只在顶层 missing 中给出一条说明；truncation 仅用于没有 ranges 的内容），多个交易对相同的元数据（ranges、omitted_columns、freshness）按字段只写一次，键名为字段名，export 将完整数据保留一小时，供同一密钥读取：read_export 凭 export.export_id 分页读取，格式与响应相同，不发起 API 请求，不计配额。它也是 MCP 资源 bytnode://exports/{id}，供能读取资源的客户端一次性读取，保留 8 位有效数字和每一行的 time。
• timeframe_applied：只要有字段使用了周期，就给出实际应用的周期；live：请求了正在形成的 K 线时出现。
• errors 和 partial：某个字段出错不会影响其他字段，某个交易对被拒绝也不会影响其他交易对。它会列在 errors 下（交易对以其名称列出），响应带有 partial: true。
• api_requests：本次调用计入配额的请求数——每个交易对的快照字段当前值合计一个，其他每个字段、每个历史和 expiries 各一个。
• oi_usd：oi 的每一行都带有以美元计的未平仓量，即 oi × 同一时间桶参考现货 K 线的收盘价（没有该 K 线时为 null），当前值同样提供，不增加请求；get_pair_brief 也带有它。同样，cvd 的每一行都带有 cumulative_net_volume，即从所返回序列最早一行开始的 net_volume 累计值：该时段的 CVD 曲线。liquidations_cumulative 的当前值是其最近一个已收盘时间桶（默认 1h），与所有行一样以起点标注时间。

#加密市场数据调用的错误

所有错误都以 Error (HTTP NNN): message 开头。当 API 已作出响应时，末尾会附上 [code: …]，即 API 稳定的 error.code。失败的工具调用会被标记为 MCP 错误（isError），绝不会作为数据返回，同一错误还会以字段形式放在 structuredContent.error 中：{status, code, message, param?, hint?, retry_after_s?}。API 给出 code 时，code 即为该值（invalid_symbol、plan_family、history_depth、rate_limited、quota_exceeded…）；否则按状态码取值（422 为 invalid_request，401 为 unauthorized…）；向错误的工具请求字段时为 wrong_tool，hint 给出正确的工具（call get_market_overview）；未知字段或列为 unknown_field，未知参数为 unknown_parameter，hint 中为 did you mean …；消息给出等待时间时，retry_after_s 即为该时长。