内容
# @bitcompare/mcp-server
官方 **加密货币收益数据 MCP 服务器**：原生 Claude 访问实时和历史加密货币借贷、储蓄、质押、借款、稳定币、价格、币种元数据和市场数据。基于 [模型上下文协议](https://modelcontextprotocol.io) 构建 — 与 Claude Desktop、Claude Code、Claude.ai 和任何 MCP 兼容的代理一起使用。
**一次 npm 安装，十八种工具，一个 API 密钥。**
```bash
npx -y @bitcompare/mcp-server
```
**需要 Bitcompare Pro 或 Enterprise 计划。** 在 <https://pro.bitcompare.net/dashboard/keys> 获取 `ck_live_*` 密钥。
## 您将获得
18 种只读工具，所有工具都受到与 REST 相同的计划限制：
- **加密货币收益数据** — 当前和历史的 CeFi 和 DeFi 提供商的借贷、借款、储蓄和质押年化收益率
- **币种** — 元数据、市场、历史、类似币种和按市值排名的查找
- **价格** — 聚合交易所价格，带有中位数和离群值过滤
- **全球市场统计** — 总市值、主导地位、恐惧与贪婪指数、24 小时最大涨幅
- **稳定币数据** — 锚定偏差排行榜、历史漂移和收益比较
- **符号解析** — 将交易所特定的 ticker（`BTC`、`XBT`、`wBTC`）映射到规范的币种 ID
完整工具目录：<https://www.bitcompare.net/mcp> · 可机读：<https://api.bitcompare.net/mcp/tools.json> · 代理清单：<https://api.bitcompare.net/llms.txt>.
## 安装
您不需要安装它 — 通过 `npx` 运行：
```bash
BITCOMPARE_API_KEY=ck_live_... npx @bitcompare/mcp-server --test
```
## 配置 Claude Desktop
编辑 `claude_desktop_config.json`（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"bitcompare": {
"command": "npx",
"args": ["-y", "@bitcompare/mcp-server"],
"env": {
"BITCOMPARE_API_KEY": "ck_live_..."
}
}
}
}
```
重启 Claude Desktop。询问“目前 BTC 的最佳收益是多少？” — Claude 将调用 `get_rates` 并从实时数据中回答。
## 配置 Claude Code
在您的项目 `.claude/settings.local.json` 中：
```json
{
"mcpServers": {
"bitcompare": {
"command": "npx",
"args": ["-y", "@bitcompare/mcp-server"],
"env": {
"BITCOMPARE_API_KEY": "ck_live_..."
}
}
}
}
```
## 主机替代方案
如果您不想安装任何东西，我们也在 `https://api.bitcompare.net/mcp` 通过 Streamable HTTP 运行 MCP 服务器。将您的 MCP 客户端指向该 URL，并使用 `Authorization: Bearer ck_live_*` 头。
## Docker
提供了一个容器用于托管内省（例如 Glama）。它安装发布的 npm 包并通过 stdio 运行服务器：
```bash
docker build -t bitcompare-mcp .
docker run -i -e BITCOMPARE_API_KEY=ck_live_... bitcompare-mcp
```
`tools/list` 内省无需密钥即可工作；工具 **调用** 需要有效的 `ck_live_` Pro 密钥。
## CLI 标志
- `--test` — 验证您的密钥并列出可用的工具，然后退出
- `--version` — 打印版本
- `--help` — 打印帮助
- `--base-url <url>` — 覆盖 API 基本 URL（用于分段/开发）
## 源代码
服务器在 Bitcompare 服务 monorepo 中开发，并作为 [`@bitcompare/mcp-server`](https://www.npmjs.com/package/@bitcompare/mcp-server) 发布到 npm。该存储库镜像发布包及其容器，以供公共发现和托管内省。
## 支持
- 文档：<https://www.bitcompare.net/mcp>
- 问题：<https://github.com/bitcompare/mcp-server/issues>
- 邮箱：<support@bitcompare.net>
## 许可证
MIT — 见 [LICENSE](./LICENSE)。
