mcp-crypto-toolkit

mcp-crypto-toolkit

为 AI Agent 提供实时加密货币价格、兑换、Gas 追踪、投资组合工具和计算器。

问问 Claude：ETH 表现如何？排名前 10 的币种有哪些？Base 上的 Gas 价格是多少？我的投资组合值多少钱？

托管版（Claude.ai 自定义连接器）： https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp
文档： DeepWiki · mcpservers.org

功能

• 实时价格，包含市值、交易量、排名、历史最高价/历史最低价（CoinGecko）
• 在加密货币和法币之间兑换（需要时通过 Binance P2P 优化 PKR）
• 按名称/符号搜索币种
• 查看热门币种及涨幅榜/跌幅榜快照
• 并排比较 2–5 种币
• 投资组合估值（批量持仓）
• 历史时点数据及区间图表（7d/30d/…）
• EVM Gas 追踪器，提供 USD 转账费用估算
• 盈亏计算器，计入交易所和网络费用
• 热门币种及加密货币恐惧与贪婪指数
• 面向常见工作流的 MCP 提示词
• 零配置 — 无需 API 密钥（可选设置 COINGECKO_API_KEY 以提高限额）
• 支持 stdio、HTTP 和 Cloudflare Workers 传输方式

快速安装

npx -y mcp-crypto-toolkit

安装

Claude Desktop / Cursor / Windsurf

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

本地构建：

{
  "mcpServers": {
    "crypto-toolkit": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-crypto-toolkit/dist/index.js"]
    }
  }
}

HTTP 服务

npm run build
npm run start:http
# POST http://localhost:3000/mcp

部署（Smithery / 远程 MCP）— 可选

为了让他人发现此服务，无需付费托管。 此服务已支持通过 npx -y mcp-crypto-toolkit（stdio）安装，并已列入 Official MCP Registry。Glama 和 PulseMCP 会从该注册表获取信息——无需支付 Fly/Railway 费用。

只有在需要远程 /mcp 端点时才部署 HTTP 服务（例如用于 Claude.ai 自定义连接器或发布 Smithery URL）。

Claude.ai 自定义连接器

公开托管的端点（Cloudflare Workers）：

https://mcp-crypto-toolkit.nad33mahm3d.workers.dev/mcp

1. 在 Claude.ai 中：Settings → Connectors → Add custom connector
2. 粘贴上面的 URL（必须包含 /mcp）
3. 你应该会看到 10 个工具（获取价格、转换、热门趋势等）

或者自行部署（Cloudflare / Docker / Render），并使用 https://YOUR-HOST/mcp。升级托管服务后，如果工具仍显示为空，请移除并重新添加连接器。

不要在 claude_desktop_config.json 中填写远程 URL——该文件仅支持 stdio。要在本地使用 Claude Desktop，建议使用：

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

Cloudflare Workers（推荐的远程方案——免费层级）

使用 Web 标准 MCP 传输方式（src/worker.ts）——无需 Docker。

在线演示：健康检查 · MCP

npm install
npx wrangler login
npm run deploy:cf

部署后：https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/health
Claude / Smithery URL：https://mcp-crypto-toolkit.<your-subdomain>.workers.dev/mcp

本地预览：npm run dev:cf

可选密钥 / 变量：

npx wrangler secret put COINGECKO_API_KEY
npx wrangler secret put MCP_API_KEY   # optional: require Bearer / x-api-key on /mcp
# Pro keys also need: wrangler.toml [vars] COINGECKO_PRO = "1"
# Optional: RATE_LIMIT_PER_MINUTE = "60" (default)

CI：添加仓库密钥 CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID——Worker 会在 GitHub Release 时自动部署（也可通过 workflow_dispatch 部署）。

Render（免费——无需信用卡）

1. 在 render.com Fork / 连接仓库
2. New → Blueprint → 指向此仓库（render.yaml 使用 Free 计划）
3. 部署后：https://YOUR-SERVICE.onrender.com/health
4. Smithery：发布 https://YOUR-SERVICE.onrender.com/mcp

免费层级在闲置约 15 分钟后会休眠；首次请求可能需要约 30 秒才能唤醒。

Docker（本地 / 自有 VPS）

docker build -t mcp-crypto-toolkit .
docker run -p 3000:3000 mcp-crypto-toolkit

付费 PaaS（免费层级无法满足需求时）：Fly.io 和 Railway 可使用随附的 fly.toml / railway.toml，但长期使用并非免费。

可选环境变量：COINGECKO_API_KEY、COINGECKO_PRO=1、Gas 预言机密钥（见下表）。

工具（10 个）

工具	描述
get_price	实时价格 + 市值、成交量、排名、历史最高价 / 最低价
convert	加密货币 ↔ 法币 / 加密货币转换
search_coin	按名称或代码搜索
top_coins	按市值 / 成交量列出前 N 名 + 涨幅榜 / 跌幅榜
compare_coins	并排比较 2–5 种加密货币
portfolio_value	计算一组持仓的价值
historical_price	指定日期或日期范围的走势图 + 投资概览
gas_tracker	Gas 费用 + 预估转账成本（USD）
profit_calc	盈亏、ROI、盈亏平衡点（含费用 + 网络费）
trending	热门加密货币 + 恐惧与贪婪指数

提示词

提示词	用途
market-overview	头部加密货币 + 热门趋势 + 市场情绪
whats-trending	热门加密货币 + 恐惧与贪婪指数
analyze-coin	一种加密货币的价格 + 7 日趋势
trade-pnl	逐步计算盈亏
gas-check	Gas + 转账成本建议

提示词示例

1. 比特币当前价格和市值是多少？
2. 搜索名称中包含“pepe”的加密货币
3. 显示前 10 种加密货币和今日涨幅榜
4. 比较 BTC、ETH 和 SOL
5. 计算我的投资组合价值：0.5 BTC 和 2 ETH，单位为 USD
6. 2024-01-01 时 ETH 的价格是多少？当时的 $1000 现在值多少？
7. 显示 SOL 过去 30 天的价格区间
8. 现在 Base 上的 Gas 费用折合 USD 是多少？
9. 我以 100 买入、以 120 卖出，数量为 10，手续费为 0.1%——利润是多少？
10. 最近有哪些热门趋势？恐惧与贪婪指数是多少？

开发

git clone https://github.com/nad33mahm3d/mcp-crypto-toolkit
cd mcp-crypto-toolkit
npm install
npm test
npm run build
npm run inspector

可选环境变量

变量	用途
COINGECKO_API_KEY	提高 CoinGecko 速率限制（仍为可选项）
COINGECKO_PRO=1	使用 Pro 标头和你的密钥
MCP_API_KEY	仅限 Worker：要求在 /mcp 上使用 Bearer / x-api-key
RATE_LIMIT_PER_MINUTE	仅限 Worker：默认值为 60
ETHERSCAN_API_KEY / BSCSCAN_API_KEY / …	提供更准确的 Gas 预言机
OPTIMISM_API_KEY	Optimism Gas 预言机
PORT	HTTP 服务端口（默认值为 3000）

如果未提供 Gas API 密钥，Gas 数据会依次回退到 Blocknative 和静态估算值。

贡献

有关设置、PR 指南和发布流程，请参阅 CONTRIBUTING.md。

• 行为准则
• 安全政策
• 支持
• 更新日志
• DeepWiki — 自动生成的架构文档
• mcpservers.org

发布（维护者）

1. 一次性设置：npm 包 Settings → Trusted Publisher → GitHub Actions → 仓库 nad33mahm3d/mcp-crypto-toolkit，工作流 publish.yml，环境 release，允许 npm publish
2. 更新 CHANGELOG.md
3. 创建一个标签为 vX.Y.Z 的 GitHub Release
4. Actions 通过 OIDC 发布到 npm（无需 NPM_TOKEN；自动生成来源证明）

API 致谢

• CoinGecko — 价格、市场、热门趋势（免费套餐，无需密钥）
• Alternative.me — 恐惧与贪婪指数
• Binance P2P — 转换为 PKR 时的 USDT/PKR 汇率
• Etherscan 系列 — 可选的 Gas 预言机
• Blocknative — Gas 备用数据源

许可证

MIT — 详见 LICENSE