Skip to main content
Glama
iuk-ink

Binance MCP Server

by iuk-ink
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Binance MCP Server

License: MIT Node.js TypeScript MCP SDK

🌐 Language: English | 日本語 | 한국어 | 简体中文

基于 Model Context Protocol (MCP) 的 Binance 合约 API 服务器，为 AI 助手（Claude Code、Cursor、Trae、OpenCode 等）提供实时行情、交易下单和技术指标计算能力。

快速开始

  • 环境： Node.js >= 18

  • API Key： 可选（不配只给行情和指标，配了才有下单）

npm install
cp .env.example .env
npm run dev   # 或：npm run build && npm start

工具全景（76 个）

期货公开（11 个，无需 Key）

工具

功能

futures_ping

连通性测试

futures_time

服务器时间

futures_exchange_info

交易规则 / 费率 / 最小下单量

futures_orderbook

订单簿深度

futures_klines

K 线数据（1m ~ 1M）

futures_agg_trades

聚合成交（分页+时间范围）

futures_trades

最新逐笔成交

futures_daily_stats

24 小时统计

futures_prices

全市场实时价

futures_all_book_tickers

最优买卖挂单

futures_mark_price

标记价格（强平依据）

期货认证（19 个，需要 API Key）

分类

工具

功能

🏦 账户查询

futures_account_balance

账户余额

futures_income

收益流水（费率/盈亏/佣金）

futures_user_trades

成交历史

⚙️ 杠杆与保证金

futures_leverage

调整杠杆 1-125x

futures_margin_type

逐仓/全仓切换

futures_position_margin

逐仓保证金调增/调减

futures_margin_history

保证金变更记录

📊 杠杆分层

futures_leverage_bracket

名义仓位杠杆阶梯（⚠️建议传symbol）

📝 下单与改单

futures_order

下单（7 种类型）

futures_update_order

修改订单（建议传 side+type）

futures_get_order

查单

futures_all_orders

全量订单（含历史）

futures_batch_orders

批量下单（≤5）

futures_cancel_batch_orders

批量取消

❌ 取消与活跃

futures_cancel_order

单笔取消（支持条件单 algoId）

futures_cancel_all_open_orders

一键清仓（需确认）

futures_open_orders

当前活跃订单（含条件单）

🛠️ 辅助工具

futures_account_report

账户全景报告（紧凑/完整可配）

futures_quick_order

一键止损/止盈（百分比自动算价）

下单类型速查表

type

用途

必需参数

平仓方式

MARKET

市价开平

quantity

SELL+LONG 自动 reduceOnly

LIMIT

限价挂单

price, quantity

同上

STOP_MARKET

市价止损

stopPrice

closePosition=true

TAKE_PROFIT_MARKET

市价止盈

stopPrice

closePosition=true

TRAILING_STOP_MARKET

追踪止损

activationPrice, callbackRate

closePosition=true

STOP

限价止损

price, stopPrice

closePosition=true

平仓速查表

场景

参数组合

市价平掉全部持仓

side=SELL, positionSide=LONG, type=MARKET, quantity=持仓数

止损平仓

type=STOP_MARKET, closePosition=true, stopPrice=触发价

止盈平仓

type=TAKE_PROFIT_MARKET, closePosition=true, stopPrice=触发价

追踪止损平仓

type=TRAILING_STOP_MARKET, closePosition=true, activationPrice=激活价, callbackRate="1"

取消条件单

futures_cancel_order(symbol, algoId=xxx)

技术指标（46 个，无需 Key）

分类

数量

工具列表

趋势

12

indicator_sma, indicator_ema, indicator_dema, indicator_rma, indicator_wma, indicator_wsma, indicator_dma, indicator_dx, indicator_adx, indicator_linreg, indicator_psar, indicator_vwap

动量

11

indicator_ao, indicator_mom, indicator_cci, indicator_macd, indicator_obv, indicator_roc, indicator_rsi, indicator_stoch, indicator_stoch_rsi, indicator_tds, indicator_williams_r

波动率

5

indicator_abands, indicator_atr, indicator_bbands, indicator_iqr, indicator_zigzag

工具函数

9

util_average, util_grid, util_max, util_min, util_median, util_quartile, util_stddev, util_streaks, util_weekday

组合信号

4

signal_ema_cross, signal_macd_rsi, signal_bb_rsi, signal_ma_cross

风险/绩效

5

util_sharpe, util_max_drawdown, util_calmar, util_win_rate, util_var

环境配置

变量

必填

说明

BINANCE_API_KEY

否

币安 API 密钥

BINANCE_API_SECRET

否

币安 API 私钥

BINANCE_TESTNET

否

测试网开关，默认 true

HTTP_FUTURES_BASE

否

期货端点，留空按 testnet 自动切换

HTTP_PROXY

否

HTTP 代理，如 http://user:pass@host:8080

MCP_SERVER_NAME

否

服务器名，默认 binance-mcp-server

LOG_LEVEL

否

日志级别：debug / info / warn / error

环境变量优先级

MCP 配置 env 块  >  .env 文件  >  代码默认值

MCP 配置文件（如 mcp.json）里设的 env 优先级最高，.env 兜底。dotenv 不会覆盖 进程已存在的环境变量。

安全建议： 用 MCP 配置的 env 块管理密钥，.env 的 Key 值清空。

配置 AI 助手

注意： MCP 配置文件不在项目目录，必须用绝对路径。以下假设项目在 E:/Github/I-binance-mcp，替换为你实际路径。

前置：先构建

npm run build

Cursor / Trae / OpenCode

{
  "mcpServers": {
    "binance": {
      "command": "node",
      "args": ["E:/Github/I-binance-mcp/dist/index.js"],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_API_SECRET": "your_secret",
        "BINANCE_TESTNET": "true"
      }
    }
  }
}

Claude Code

claude mcp add binance -- node E:/Github/I-binance-mcp/dist/index.js

架构

src/
├── index.ts              ← 入口
├── server.ts             ← McpServer 创建 + 条件注册
├── config/binance.ts     ← 配置（端点 / 代理 / 认证）
├── types/common.ts       ← ToolDefinition 泛型 + BinanceClient 类型
├── utils/                ← 响应工厂 / 日志 / 校验 / 脱敏 / 限流
└── domain/
    ├── futures/          ← 期货：公开(11) + 认证(19)
    │   ├── schemas.ts    ← Zod Schema（聚合导出）
    │   ├── schemas/
    │   │   ├── public.ts     ← 公开 Schema (10)
    │   │   └── authenticated.ts ← 认证 Schema (18)
    │   ├── public.ts     ← 公开 handler
    │   ├── authenticated.ts ← 认证 handler
    │   └── index.ts
    └── indicators/       ← 技术指标(46)
        ├── schemas.ts    ← 指标参数 Schema
        ├── format.ts     ← 精度格式化
        ├── trend.ts (12) / momentum.ts (11)
        ├── volatility.ts (5) / utility.ts (9)
        ├── signals.ts (4) / risk.ts (5)
        └── index.ts

条件注册： API Key 存在 → 76 工具；不存在 → 57 工具。

命令

命令

说明

npm run dev

开发模式（tsx）

npm run build

编译

npm start

运行编译产物

npm run typecheck

类型检查

npm run watch

热重载

npx tsx test/smoke-test.ts

冒烟测试（30 项）

技术栈

组件

版本

用途

@modelcontextprotocol/sdk

^1.29

MCP 框架（registerTool）

binance-api-node

^0.13

币安 API 客户端

trading-signals

^7.4

技术指标计算

zod

^4.4

Schema → JSON Schema 自动生成

dotenv

^17.4

环境变量

typescript

^6.0

主语言

安全

  • 密钥仅从环境变量注入，不写入代码或日志

  • 错误消息自动脱敏（api_key → [API_KEY]、signature → [SIGNATURE]）

  • STOP_MARKET / TAKE_PROFIT_MARKET 自动显式传 closePosition（避免 undefined 被 JSON 丢弃）

  • Hedge 模式下 SELL+LONG 自动设 reduceOnly=true，防止误开反向仓位

  • 建议始终在 BINANCE_TESTNET=true 模式下测试交易功能

  • 生产环境设 LOG_LEVEL=error

许可证

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1wRelease cycle
3Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/iuk-ink/binance-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server