@iuk-ink/binance-mcp-server
v3.1.0
Published
Binance USDS-M Futures MCP server: 61 tools across market / indicator / analysis / trading domains, built on MCP server v2 + official Binance SDK
Maintainers
ayurkReadme
Binance MCP Server
基于 Model Context Protocol 的 Binance U 本位期货 MCP 服务器，为 AI 助手提供 61 个 MCP 工具，覆盖行情数据、技术指标、风险分析与期货交易。
构建于 MCP server v2 SDK 与币安官方 SDK（@binance/derivatives-trading-usds-futures）之上，全部数值经交易所精度规则自动规整，含两级行情缓存、-1007 超时幂等恢复与时钟偏差检测。
快速开始
零配置体验（仅分析，不交易）
npx @iuk-ink/binance-mcp-server无需 API Key，默认连接测试网，即可使用行情、指标与风险分析工具。
配置 MCP Client
{
"mcpServers": {
"binance": {
"command": "npx",
"args": ["-y", "@iuk-ink/binance-mcp-server"],
"env": {
"BINANCE_TESTNET": "true"
}
}
}
}如需交易功能，补充 BINANCE_API_KEY 与 BINANCE_API_SECRET。
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|------|:---:|------|------|
| BINANCE_TESTNET | 否 | true | 测试网（虚拟金） / 主网 |
| BINANCE_USE_DEMO | 否 | false | demo 交易环境（与主网凭证共用） |
| BINANCE_BASE_URL | 否 | — | 自定义 REST 端点（优先级最高） |
| BINANCE_API_KEY | 否 | — | 不填则交易工具不注册 |
| BINANCE_API_SECRET | 否 | — | 同上 |
| BINANCE_PROXY_URL | 否 | — | HTTP/HTTPS 代理地址 |
| BINANCE_TIMEOUT | 否 | 10000 | 请求超时（毫秒） |
| BINANCE_RETRIES | 否 | 3 | 网络重试次数 |
| BINANCE_BACKOFF | 否 | 1000 | 重试退避基数（毫秒） |
| BINANCE_RECV_WINDOW | 否 | 5000 | 签名时间窗（毫秒） |
| MCP_TOOL_DOMAINS | 否 | 全部 | 工具域过滤，逗号分隔：market,trading,indicator,analysis |
| MCP_SERVER_NAME | 否 | binance-mcp-server | MCP 服务名 |
| MCP_TRANSPORT | 否 | stdio | 传输模式：stdio（本地）/ http（远程，见下节） |
| MCP_HTTP_HOST | 否 | 127.0.0.1 | HTTP 模式监听地址（非本机绑定时强制要求令牌） |
| MCP_HTTP_PORT | 否 | 3100 | HTTP 模式监听端口 |
| MCP_HTTP_TOKEN | 否 | — | HTTP 模式 Bearer 令牌；非本机绑定时必填 |
| MCP_HTTP_ALLOWED_HOSTS | 否 | 自动推导 | HTTP 模式 Host 白名单（逗号分隔）；通配绑定时必填 |
| LOG_LEVEL | 否 | info | debug / info / warn / error |
远程 / HTTP 接入
默认 stdio 适合本地单客户端（进程被客户端直接启动）。需要远程部署 / 多客户端共享时启用 Streamable HTTP。
涉及两层独立配置，请务必区分：
- 服务端（运行 MCP 进程的机器）：用环境变量配置监听地址与认证
- 客户端（AI 助手 / IDE 等连入方）：用 JSON 配置指定连接地址与令牌
第 1 步：服务端启动（环境变量）
# 仅本机访问（默认，无需令牌）
MCP_TRANSPORT=http
MCP_HTTP_PORT=3100
npx @iuk-ink/binance-mcp-server
# 对外暴露（必须配令牌认证，否则拒绝启动）
MCP_TRANSPORT=http
MCP_HTTP_HOST=0.0.0.0
MCP_HTTP_PORT=3100
MCP_HTTP_TOKEN=your-long-secret
MCP_HTTP_ALLOWED_HOSTS=your-domain.com
npx @iuk-ink/binance-mcp-server启动后验证服务已就绪：
curl http://127.0.0.1:3100/health # 期望 {"ok":true,"uptime":<秒>}第 2 步：客户端配置（JSON）
支持 Streamable HTTP 的 MCP 客户端，按「服务端是否设了令牌」二选一：
// 无令牌（仅本机，服务端未设 MCP_HTTP_TOKEN）
{
"mcpServers": {
"binance": { "type": "http", "url": "http://127.0.0.1:3100/mcp" }
}
}
// 有令牌（对外暴露，需在 headers 中回传 Bearer 令牌）
{
"mcpServers": {
"binance": {
"type": "http",
"url": "http://your-server:3100/mcp",
"headers": { "Authorization": "Bearer your-long-secret" }
}
}
}常见误区：服务端的
MCP_HTTP_*环境变量作用域仅限服务端进程。客户端无法通过 JSON 配置这些变量来配置服务器——JSON 只管「连到哪 + 带什么认证头」。
安全须知（交易服务器暴露 = 任何能连接的客户端都可用你的凭证交易）
- 默认仅监听
127.0.0.1（本机），无需令牌 - 绑定非本机地址时必须设置
MCP_HTTP_TOKEN（Bearer 认证），否则拒绝启动 - 通配绑定（
0.0.0.0）时必须设置MCP_HTTP_ALLOWED_HOSTS（Host 白名单，DNS rebinding 防护） - 公网部署强烈建议：令牌 + 反向代理 TLS（nginx / Caddy），且令牌应足够长且随机
- 行情缓存跨请求共享（常驻进程），等价于多客户端复用一个服务实例，注意同一服务实例上的所有客户端共享同一组币安凭证与风控额度
工具清单（61 个，主网）
测试网下 57 个（4 个情绪端点仅主网可用，不注册）。
市场数据（18）
| 工具 | 说明 |
|------|------|
| market_price | 最新成交价 |
| market_book_ticker | 最优买卖报价+量（比 orderbook 轻量得多） |
| market_orderbook | 订单簿多档深度（5/10/20/50/100/500/1000） |
| market_klines | K 线历史数据 |
| market_24hr_ticker | 24h 涨跌幅 / 最高 / 最低 / 成交量 |
| market_mark_price | 标记价（= 清算参考价，含资金费率） |
| market_open_interest | 未平仓合约量（OI） |
| market_funding_rate | 当前资金费率与上下限 |
| market_funding_rate_history | 历史资金费率 |
| market_continuous_klines | 永续 / 当季 / 次季连续合约 K 线（基差分析） |
| market_exchange_info | 交易规则 / 精度 / 最小下单量 |
| market_overview | 一站式快照：行情 + 指标 + 资金费率 + 盘口，单次调用 |
| market_ping / market_time | 连通性测试 / 服务器时钟校准 |
| market_open_interest_hist | OI 历史统计（仅主网） |
| market_long_short_ratio | 全账户多空比（仅主网） |
| market_taker_volume | 主动买卖量比（仅主网） |
| market_top_trader_ratio | 大户持仓多空比（仅主网） |
技术指标（19）
直连设计：一步完成「拉取 K 线 → 计算指标」，无需先调 market_klines。
| 类别 | 工具 |
|------|------|
| 趋势 | indicator_sma / indicator_ema / indicator_macd / indicator_adx / indicator_super_trend / indicator_vwap |
| 动量 | indicator_rsi / indicator_stoch / indicator_cci / indicator_mfi / indicator_obv |
| 波动 | indicator_atr / indicator_bbands / indicator_volatility_regime |
| 组合信号 | indicator_ma_cross（均线交叉）/ indicator_macd_rsi / indicator_bb_rsi / indicator_divergence（RSI 背离） |
| 批量 | indicator_multi（一次调用 = RSI + MACD + BBands + 可选 ATR / ADX / Stoch） |
风险分析（3）
| 工具 | 说明 |
|------|------|
| analysis_sharpe | Sharpe + Sortino + 年化收益 / 波动（按 K 线周期自动推断年化系数） |
| analysis_drawdown | 最大回撤（含峰谷价位与位置） |
| analysis_var | VaR / CVaR（置信度 0.5~0.99 可调） |
期货交易（21，需 API Key）
| 分类 | 工具 |
|------|------|
| 账户 | trading_balance / trading_account / trading_positions / trading_income / trading_commission |
| 订单 | trading_place_order（含 dryRun 演练）/ trading_place_algo（止损 / 止盈 / 追踪止损）/ trading_modify_order / trading_cancel_order / trading_cancel_algo / trading_cancel_all |
| 查询 | trading_get_order / trading_open_orders / trading_order_history / trading_trades / trading_force_orders / trading_algo_orders |
| 配置 | trading_set_leverage / trading_set_margin_type / trading_position_margin / trading_position_mode |
下单自动完成：价格 / 数量精度向下规整（tickSize / stepSize）、最小名义价值校验、-1007 撮合超时后以幂等订单号查证成交状态再决定是否重试。
特性亮点
market_overview一站式快照（单次调用聚合行情 / 指标 / 资金 / 盘口）- 多协议接入：本地 stdio 直启，或 Streamable HTTP 远程部署 / 多客户端共享
MCP_TOOL_DOMAINS工具域过滤、BINANCE_USE_DEMO/BINANCE_BASE_URL环境切换- 两级缓存（exchangeInfo 5min + K 线 3s，飞行中去重）
-1007撮合超时幂等恢复、时钟偏差启动检测- 下单精度自动规整 + 最小名义价值前置校验
- 参数校验全面对齐官方约束（clientOrderId 字符集、GTD 上界、追踪止损回撤率 0.1~10 等）
AI 使用指南（Skill）
仓库内置 skills/binance-trader/SKILL.md——为 AI 助手编写的使用手册，涵盖工具选择决策、跨工具工作流、交易安全纪律与错误恢复剧本。支持 Skill 机制的客户端（Claude Code / Trae 等）可直接挂载，让 AI 从"能用工具"升级为"用好工具"。
本地开发
git clone https://github.com/iuk-ink/binance-mcp-server
cd binance-mcp-server
npm install命令
| 命令 | 用途 |
|------|------|
| npm run dev | tsx 直接启动，开发时使用 |
| npm run typecheck | TypeScript 类型检查 |
| npm test | node:test 运行全部 196 个测试（无网络依赖） |
| npm run build | 编译到 dist/ |
| npm start | 运行编译产物 |
License
MIT