crypto-pulse-mcp

crypto-pulse-mcp

通过 Model Context Protocol 为 AI 助手提供只读加密货币市场数据。 向 Claude（或任何 MCP 客户端）询问价格、资金费率、未平仓合约、DeFi 总锁仓价值（TVL）和稳定币流向，即可从公共 API 获取 结构化答案。无需 API 密钥。不能交易。无法访问账户。

工具	可回答的问题
get_price	Bybit 和 Binance 上的现货价格、24 小时涨跌幅／区间／成交量，以及两者之间的价差
get_derivatives	永续合约资金费率（也提供年化值）、基差、未平仓合约及其与成交量的比值
get_market_overview	按市值或成交量排名的顶级币种、24 小时涨跌幅、距历史最高价的距离、市场广度（CoinGecko）
get_defi_tvl	TVL 排名前列的链、某条链上的顶级协议（例如 Solana、Stellar），或某个协议（DefiLlama）
get_stablecoins	规模最大的美元稳定币、供应量占比和 1d/7d/30d 供应量变化，可粗略反映资金流入或流出加密货币市场的情况

连接后可以尝试以下提示词：

• “现在 SOL 在 Bybit 上的交易价格是否高于 Binance？”
• “BTC 的资金费率如何？多头是不是过于拥挤？”
• “Stellar DeFi 规模有多大？哪些协议领先？”
• “本周稳定币供应量是在增长还是减少？”

示例

在已连接该服务的 Claude Code 中提问（数据快照，2026 年 10 月 22 日）：

SOL 在 Bybit 上的价格高于 Binance 吗？BTC 的资金费率如何？Stellar DeFi 规模有多大？

• SOL（get_price）： 没有溢价。Bybit 上为 $103.82，Binance 上为 $103.83，相差约 0.01%。
• BTC 资金费率（get_derivatives）： 略为负值，Bybit 上每 8 小时为 -0.0041%（年化约 -4.5%），因此空头向多头支付费用。多头看起来并不拥挤。
• Stellar DeFi（get_defi_tvl）： TVL 约为 $241M，在各链中排名第 18。排名第一的协议是 Blend Pools V2，约为 $140M。

安装

需要 Node.js 20 或更高版本。最快的方式是使用 npx，无需克隆：

claude mcp add crypto-pulse -- npx -y crypto-pulse-mcp

在 Windows 上，请从 cmd 运行（PowerShell 会吞掉 --），并用包装命令启动 npx，以便 Claude Code 启动它：

claude mcp add crypto-pulse -- cmd /c npx -y crypto-pulse-mcp

添加 -s user，即可在所有文件夹中使用，而不只限于当前项目。

已发布到 npm，也已收录在官方 MCP Registry 中，名称为 io.github.markankamaransheogarat-sys/crypto-pulse-mcp。

如需从源码运行：

git clone https://github.com/markankamaransheogarat-sys/crypto-pulse-mcp.git
cd crypto-pulse-mcp
npm install
npm run build

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "crypto-pulse": {
      "command": "npx",
      "args": ["-y", "crypto-pulse-mcp"]
    }
  }
}

在 Windows 上，使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "crypto-pulse-mcp"]。

Claude Code

claude mcp add crypto-pulse -- node /absolute/path/to/crypto-pulse-mcp/dist/index.js

任何能够启动 stdio 服务的其他 MCP 客户端也可以用同样的方式运行。

值得了解的细节

• 交易对符号。 BTC、ETH/USDT、SOLUSDT 和 doge-usdt 均可使用；只写币种名称时，默认表示 USDT 交易对。
• 一个交易所无法访问不代表请求失败。 get_price 和 get_derivatives 会并行查询两个交易所。如果其中一个无法访问（Binance 在部分国家／地区会受到地理限制），仍会返回另一个交易所的数据，并通过 errors 字段说明情况。未知交易对会标记为“未上线”，而不会报告为服务中断。
• 缓存。 响应会短暂缓存（交易所行情数据缓存 5 s，CoinGecko 缓存 60 s，DefiLlama 缓存 5 min），以符合免费套餐的速率限制。同时发起的相同请求会共用一次调用。
• 资金费率正负号。 正资金费率表示多头向空头支付费用。annualizedFundingPct 假设今天的费率全年不变，但实际并非如此；应将其视作量级参考，而非预测。
• DefiLlama 的 CEX 条目（交易所钱包余额）不会计入各链的协议排名。
• 不构成财务建议。 这些数据是公共数据的快照，可能存在数秒至数分钟的延迟。

开发

npm run typecheck   # tsc --noEmit over src and tests
npm test            # vitest, all HTTP mocked
npm run build       # compile to dist/
node scripts/smoke.mjs   # live check: starts the built server and calls every tool against the real APIs

目录结构：src/sources/* 分别对接一个 API 并返回标准化数据结构，src/tools/* 存放逻辑且各自注册一个 MCP 工具，src/http.ts 是共享客户端（超时、有限重试、TTL 缓存），src/symbols.ts 用于标准化交易对符号。

数据源

Bybit v5 · Binance 现货 和 USDⓈ-M 合约 · CoinGecko · DefiLlama。本项目与以上任何平台均无关联， 请遵守其条款和速率限制。

许可证

MIT