用途
mcp-server 是 Bitcompare 官方推出的加密货币收益数据 MCP 服务器，基于 Model Context Protocol 构建，让 Claude 等 MCP 兼容智能体能够直接访问实时与历史的加密借贷、储蓄、质押、借入、稳定币、价格、币种元数据及市场数据。
主要能力
提供 18 个只读工具，均受与 REST 相同的订阅计划限额约束：
- 加密收益数据：CeFi 与 DeFi 提供商的当前及历史借贷、借入、储蓄、质押 APY。
- 币种数据：元数据、市场、历史、相似币种、按市值排名查询。
- 价格：聚合交易所价格，带中位数与异常值过滤。
- 全球市场统计：总市值、主导地位、恐惧与贪婪指数、24 小时涨跌榜。
- 稳定币数据：锚定偏差排行榜、历史漂移、收益比较。
- 符号解析：将交易所特定代码（BTC、XBT、wBTC）映射到规范币种 ID。 完整工具目录见 https://www.bitcompare.net/mcp ，机器可读版本见 https://api.bitcompare.net/mcp/tools.json ，智能体清单见 https://api.bitcompare.net/llms.txt 。
使用方式
无需安装，可通过 npx 运行：
npx @bitcompare/mcp-server
配置 Claude Desktop：编辑 claude_desktop_config.json（macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json），添加对应服务器配置后重启 Claude Desktop。随后可提问“what's the best yield on BTC right now?”，Claude 会调用 get_rates 并基于实时数据回答。
配置 Claude Code：在项目的 .claude/settings.local.json 中进行相应配置。
托管替代方案：若不想安装任何内容，也可通过 Streamable HTTP 使用托管 MCP 服务器 https://api.bitcompare.net/mcp ，在 MCP 客户端中指向该 URL 并附带 Authorization: Bearer ck_live_* 请求头。
容器：提供用于托管内省的容器（例如 Glama），会安装已发布的 npm 包并通过 stdio 运行服务器。
tools/list 内省无需密钥；工具调用需要有效的 ck_live_ Pro 密钥。
命令行选项：
- --test — 验证密钥并列出可用工具，然后退出
- --version — 打印版本
- --help — 打印帮助
- --base-url <url> — 覆盖 API 基础 URL（用于预发布/开发）
适用场景
适用于需要在对话式智能体中查询加密收益、币种信息、市场价格、稳定币状态等数据的用户，尤其是已使用 Bitcompare Pro 或 Enterprise 计划并希望在 Claude 等 MCP 客户端中直接获取实时数据的场景。
限制
需要 Bitcompare Pro 或 Enterprise 计划，并在 https://pro.bitcompare.net/dashboard/keys 获取 ck_live_* 密钥。工具为只读，且受计划限额约束。服务器在 Bitcompare 服务 monorepo 中开发，并以 @bitcompare/mcp-server 发布到 npm；本仓库镜像已发布包及其容器，用于公开发现与托管内省。
