modelscope·@WilliamNing316/crypto-mcp-server
暂无描述。
这是一个使用 TypeScript 编写的加密货币 Model Context Protocol (MCP) 服务器通过 Binance 公共 API 提供实时行情查询能力 你可以将其接入 ChatGPTClaude DesktopStrands 或任何支持 MCP 的客户端让 AI 直接调用加密货币工具
当前实现了 5 个强大的工具覆盖从基础价格查询到深度市场分析
获取指定交易对的实时价格
输入参数
symbol交易对符号如 BTCETHSOL不区分大小写quote报价货币如 USDTBUSD默认 USDT输出
使用示例
"BTC 现在多少钱"
调用 get_price({ symbol: "BTC", quote: "USDT" })
获取交易对过去24小时的完整统计数据包括涨跌幅成交量最高/最低价等
输入参数
symbol交易对符号如 BTCETHquote报价货币默认 USDT输出
使用示例
"ETH 今天涨了多少"
调用 get_24h_stats({ symbol: "ETH" })
获取技术分析所需的K线蜡烛图数据支持多种时间间隔
输入参数
symbol交易对符号quote报价货币默认 USDTintervalK线时间间隔1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M默认 1hlimit返回的K线数量1-1000默认 500输出
使用示例
"给我 BTC 最近10小时的K线数据"
调用 get_ohlcv({ symbol: "BTC", interval: "1h", limit: 10 })
智能组合工具整合多个数据源提供交易对的全面分析
输入参数
symbol交易对符号quote报价货币默认 USDT输出
使用示例
"BTC 今天怎么样属于上涨还是盘整"
调用 get_symbol_overview({ symbol: "BTC" })
这个工具特别适合回答综合性的市场分析问题模型可以基于返回的数据生成自然语言回答
查看市场流动性深度和买卖盘强度适合做交易分析
输入参数
symbol交易对符号quote报价货币默认 USDTlimit订单深度数量5-5000默认 100输出
使用示例
"BTC 的买卖盘深度怎么样"
调用 get_order_book({ symbol: "BTC", limit: 20 })
本项目使用 Binance 公开 REST API
GET /api/v3/ticker/priceGET /api/v3/ticker/24hrGET /api/v3/klinesGET /api/v3/depth无需 API Key无限制地调用基础行情数据
npm install
npm run build
npm start
npm run dev
get_price编辑 claude_desktop_config.jsonmacOS 路径~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"crypto-mcp": {
"command": "node",
"args": ["/path/to/trade_mcp/dist/server.js"],
"transport": "stdio"
}
}
}
根据客户端文档配置确保
command: nodeargs: ["dist/server.js"]使用绝对路径transport: stdio配置好后即可在客户端中直接使用所有工具
如果环境支持浏览器推荐使用 MCP Inspector
npx @modelcontextprotocol/inspector node dist/server.js
你可以
如果服务器环境无法打开浏览器可以使用命令行测试脚本
# 1. 先编译项目
npm run build
# 2. 运行测试脚本测试 MCP 服务器
npm test
# 或
node test/test-server.js
测试脚本会
验证网络连接和 API 可用性
node test/test-api-direct.js
这会直接调用 Binance API不经过 MCP 服务器用于诊断网络问题
用户"BTC 现在多少钱"
模型调用 get_price "BTC 当前价格为 $92,026.49 USDT"
用户"BTC 今天怎么样属于上涨还是盘整"
模型调用 get_symbol_overview
"BTC 今天表现良好属于上涨趋势当前价格 $92,028.73
24小时涨幅 0.975%最高价 $93,160最低价 $88,608
根据K线分析呈现明显上涨趋势交易量很高市场活跃"
用户"给我 ETH 最近10小时的K线数据"
模型调用 get_ohlcv({ symbol: "ETH", interval: "1h", limit: 10 })
返回详细的K线数据供分析
用户"BTC 的买卖盘深度怎么样"
模型调用 get_order_book
"BTC 当前最佳买价 $92,026.49最佳卖价 $92,026.50
价差仅 0.0001%流动性很好买盘总量 $XXX卖盘总量 $XXX
买卖盘比例平衡市场深度充足"
你可以轻松添加更多 Binance API 工具例如
参考现有工具的实现方式在 src/server.ts 中添加新的 Schema 和函数即可
API 速率限制Binance 公共 API 有速率限制当前非常宽松如需高频请求建议添加缓存机制
数据格式MCP 工具返回时应保持 JSON 格式AI 才能稳定理解
交易功能若要扩展版本到交易/下单功能需要使用 Binance API Key本项目默认未涉及资金操作
网络连接确保服务器可以访问 api.binance.com
错误处理所有工具都包含完善的错误处理会返回友好的错误信息
欢迎提交 Issue 和 Pull Request
MIT License
暂无描述。
暂无描述。
暂无描述。
暂无描述。
暂无描述。
通过模型上下文协议接口提供来自OKX交易所的实时加密货币价格数据。