Bitculator

更新日志

MCP 服务器更新日志

位于 /mcp 的 MCP 服务器的每一项变更 - 工具、输入、结果、密钥与限制 - 最新在前。哪些算作破坏性变更,详见其政策。

  1. 变更

    401 不再暗示 OAuth

    来自 /mcp 的 401 现在携带 WWW-Authenticate: ApiKey realm="mcp",而不是 Bearer realm="mcp", error="invalid_token",后者曾让部分客户端去寻找 OAuth 服务器。密钥仍可通过 Authorization: Bearer 或 X-API-Key 传递。

  2. 新增

    结构化结果与输出 schema

    成功的工具调用会在保持不变的 JSON 文本旁返回 structuredContent,并且对于响应已在 OpenAPI 契约中记录的每个工具,tools/list 都会发布一个 outputSchema。错误仍为纯 isError 文本。

  3. 修复

    全部 19 个工具在一页 tools/list 中返回

    tools/list 过去每页返回 15 个工具并附带 nextCursor,因此忽略游标的客户端永远看不到 get_coin_markets、get_coin_technicals、get_liquidations_summary 或 calculate_dca。现在全部 19 个工具都在一页中返回。

  4. 修复

    交易所工具恢复响应

    自上线以来,get_exchange 和 get_exchange_trust_score 对每个交易所都返回内部错误。现在两者都能正常响应;输入和结果字段均不变。

  5. 修复

    已关闭的工具再次如实告知

    自 9 月 6 日起,已关闭的工具会返回 server_error (HTTP 500)。现在它再次返回 endpoint_unavailable (HTTP 503): This endpoint is temporarily unavailable.。

  6. 修复

    修正 get_altseason_index 的 days

    days 曾标示默认值和最小值为 0,但 0 一直都会被拒绝。现在其取值范围为 1-365,且没有默认值;如需获取当前读数,请省略该参数。get_global_history 的描述现在说明了数据点的结构({time, marketcap} 或 {time, volume})。

  7. 新增

    静态服务器卡片

    新增无需身份验证的 /.well-known/mcp/server-card.json,包含 serverInfo 和完整的工具定义,缓存一小时,供无法扫描需要密钥的服务器的注册中心使用。它和 /.well-known/mcp.json 现在都可以跨源读取。

  8. 新增

    密钥可通过 X-API-Key 请求头传递

    /mcp 现在也接受以 X-API-Key: YOUR_API_KEY 发送的 MCP 密钥,适用于将 Authorization 专用于自身登录的客户端和网关。发送该请求头时,只会校验其中的密钥,并且可以容忍粘贴进来的 Bearer 前缀。

  9. 变更

    身份验证失败改为按密钥限流

    身份验证失败过去按每个 IP 每分钟最多 30 次限制,超出后该 IP 背后的所有密钥都会被拒绝。现在,单个密钥在单个 IP 上每分钟最多可失败 30 次,单个 IP 最多 300 次,且大约最近 15 分钟内成功通过验证的密钥不会被 IP 上限阻止。

  10. 变更

    结果中加入 Fear & Greed 指数(0-100)

    get_fear_greed(主读数和每个时间区间)和 get_global_market(fear_greed)现在会在原始 score 旁包含 index - 即 Bitculator 上显示的 0-100 指数 - 工具描述也会告诉模型引用 index。

  11. 修复

    get_coin 的完全稀释估值

    对于最大供应量没有上限的币种,get_coin 过去会将完全稀释估值返回为 0。现在改为回退到总供应量,两者均未知时为 null。

  12. 修复

    涨跌榜排序、代码查询与市场份额

    get_top_movers 现在按涨跌幅本身排名(此前实际上按市值排名),其跌幅榜会排除持平于 0.00 的币种。带 symbols 的 get_prices 每个代码只返回一个币种,即排名最高的活跃币种;当没有市值时,get_global_market 会将 BTC 和 ETH 的市场份额报告为 null,而不是 0。

  13. 修复

    修正说明与描述

    initialize 说明现在指出市值和交易量为 JSON 数字(此前写的是十进制字符串),list_exchanges 的 sort 描述给出了真实的默认值 -volume,get_exchange_trust_score 也注明未排名的交易所其评分和明细为 null。

  14. 新增

    列入发现文档

    服务器已列入 /apis.json 和 /.well-known/api-catalog,/.well-known/mcp.json 新增了 status 和 changelog 链接,/status.json 也会报告一个 mcp 组件。

  15. 变更

    专属密钥、套餐与配额

    破坏性变更:/mcp 只接受在 MCP 控制台中创建的密钥;Data API 密钥和组件密钥会得到 401。MCP 拥有自己的 Free(每月 2,500 次工具调用)、Starter(50,000 次)和 Pro(250,000 次)套餐,分别提供 2、5 和 10 个密钥名额,并拥有自己的计费和按工具划分的套餐门槛,每个账户都从 Free 起步。配额和套餐错误现在会写明 MCP 套餐。

  16. 变更

    突发限制覆盖所有请求

    发往 /mcp 的每个 JSON-RPC 请求 - initialize、tools/list、ping 和工具调用 - 现在都计入套餐每分钟 30、60 或 120 次的突发限制,超出时返回 HTTP 429。只有工具调用计入月度配额。

  17. 修复

    服务器错误不再显示内部细节

    工具的服务器错误过去会包含内部错误消息。现在显示为 server_error (HTTP 500): Internal server error.。

  18. 修复

    生产环境中工具调用失败

    从上线到此次修复,生产环境中的每次工具调用都返回 server_error,因为服务器把自己的内部数据请求当作来自不受信任主机的请求而拒绝了。

  19. 新增

    MCP 服务器上线

    /mcp 通过 Streamable HTTP(仅限 POST)上线,为 Claude、Cursor、VS Code 及任何 MCP 客户端提供 19 个只读工具,从 search_coins 和 get_coin 到 calculate_dca,返回与 REST API 相同的数据。它使用 Data API 的密钥、套餐和配额,每次工具调用计为一次请求,并由 /.well-known/mcp.json 对其进行描述。

获取通知

移除或重命名某个工具或输入,会至少提前六个月在此处公布 - 参见弃用政策。位于 /.well-known/mcp.json 的服务器卡片会链接到本更新日志。