Binance MCP Server


Ein usDT-margined-Futures-MCP-Server auf Basis des Model Context Protocol. Er stellt KI-Asstistenten 61 MCP-Tools fur Marktdaten, techische Indikatoren, Risikatelyse und Futures-Handel ber.

Er baute auf dem MCP Server-v-SDK and dem offiziell binance-SDK (@binance/derivatives-trading-usds-futures) und erbringt. Allie Werte and server(unim Sd um).

Schnellstart

Null-Konfuration-Experipuenz (nur Analyse, kein Handle)

npx @iuk-ink/binance-mcp-server

Ohne API-Key and mit nervorgabesmassiger Verbindung zu den Testinet können Marktdaten, Indikatoren und Risikoanalyse-Tools verwendet werden.

MCP-Cient-Configurieren

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["-y", "@iuk-ink/binance-mcp-server"],
      "env": {
        "BINANCE_TESTNET": "true"
      }
    }
  }
}

Für 亨del funktionen ergänzen Sie BINANCE_API_KEY und BINANCE_API_SECRET.

Umgebungs-Variablen

| Ariable | | 必填 | 准默认er | 说明 | | ---- | :-: | ---- | ---- | | BINANCE_TESTNET | 否 | true | Testizin（virtuelles Geld） / 主网 | | BINANCE_USE_DEMO | 否 | false | demo 交易环境（与主网凭证共用） | | BINANCE_BASE_URL | 否 | — 自定义 REST 端点（优先级最大） | | BINANCE_API_KEY | 否 | — 不填则交易工具不注册 | | BINANCE_API_SECRET | 否 | — | 同上 | | BINANCE_PROXY_URL | 否 | — HTTP/HTTPS proxy 地址 | | BINANCE_TIMEOUT | 否 | 100000 | 请求超时（毫秒） | | BINANCE_RETRIES | 否 | 3 | 网络重试次数 | | BINANCE_BACOFF | 否 | 1000 | 重试退避基数（毫秒） | | BINANCE_SECV_WWINNEE | 否 | 500 | 签名时间窗口（毫秒） | | MCP_TOOL_DOMAINS | 否 | 全部 | 工具域过滤器，逗号分隔：market,trading,indicator,analysis | | MCP_SERVER_NAEE | 否 | binance-mcp-server | MCP 服务名 | | LOG_LEVEL | 否 | info | debug / info / warn / error |

Related MCP server: Binance MCP Server

工具清单（61 个，主网）

测试网下 57 个（4 个情绪端点仅主网可用，不注册）。

价格数据（18）

技术指标（19）

直连设计：一次就完成「拉出 K线 → 计算指标」，无需先调 market_klines。

风险分析（3）

期货交易（21，需 API 钥匙）

下单自动：价格 / 数量按精度向下取整（tickSize / stepSize）分母做合法检查；-1000 超时同步等态，通过幂等后订单号查成交状态再决定是否重试。

从 2.x 迁移到 3.x

破坏性变更

• MCP SDK：@modelcontextprprocol/sdk@1 → @modelcontextprotcol/server@2（官方包名变更）

• 币安接入：社区包 binance@3 → 正式版 @binance/derivatives-trading-usds-utures@38

• Node.js：>=18 → >=20

• 代理变量：HTTP_PROXY → BINANCE_PROXY_URL

• 工具集 76→61：去除统计辅助域（均值 / 极值 / 分位数等 10 个）和指标独立版 / 冗余的信号版变体；旧版 _direct 后缀工具改为无后缀命名（如 rsi_direct → indicator_rsi）；风险指标更（ris_* → analysis_*）

• 工具名前缀：所有工具带上域前缀（market_ / indicator_ / analysis_ / trading_），AI 客户端已有提示语和流程需按新名调整

新增能力

• market_overview 一站式快照（一次调用聚合行情 / 标 / 资金 / 盘口）

• MCP_TOOL_DOMAIN 域过滤，BINANCE_USE_DEMO / BINANCE_BASE_URL 环境切换

• 二极缓存（exchangeInfor 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

命令

许可证

MIT