币安MCP交易接口

@mixuechu/binance-mcp
1 Stars 181 次浏览 mixuechu 更新于 2026-08-23

一个为Binance交易所提供加密货币交易接口的模型控制协议(MCP)服务器,支持实时价格获取、账户余额查询、下单/撤单以及自动化套利策略等功能。

该服务暂未提供标准配置,请参考 README 手动接入

可用工具 (9 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

get_symbol_price 1 个参数 需填 1 项

Get the current price of a cryptocurrency pair. Args: symbol: The cryptocurrency pair, e.g., BTCUSDT. Returns: Price information from Binance.

必填参数:symbol

get_account_balance 1 个参数 需填 1 项

Get the balance of a specific cryptocurrency asset. Args: asset: The cryptocurrency symbol, e.g., BTC. Returns: Asset balance info.

必填参数:asset

place_market_order 3 个参数 需填 3 项

Place a market order to buy or sell. Args: symbol: The trading pair, e.g., BTCUSDT. side: BUY or SELL. quantity: Amount to trade. Returns: Order placement result.

必填参数:symbol、side、quantity

get_trade_history 2 个参数 需填 1 项

Get recent trade history for a pair. Args: symbol: The trading pair. limit: Number of trades to fetch. Returns: List of trade summaries.

必填参数:symbol

get_open_orders 1 个参数 需填 1 项

Get open orders for a symbol. Args: symbol: The trading pair. Returns: List of open orders.

必填参数:symbol

cancel_order 2 个参数 需填 2 项

Cancel a specific order. Args: symbol: The trading pair. order_id: Order ID to cancel. Returns: Cancellation result.

必填参数:symbol、order_id

get_funding_rate_history 2 个参数 需填 1 项

Get funding rate history. Args: symbol: Perpetual contract symbol. limit: Number of records to return (default 100). Returns: Funding rate data list.

必填参数:symbol

execute_hedge_arbitrage_strategy 2 个参数 需填 2 项

Execute hedge arbitrage based on funding rate. Args: symbol: The trading pair. quantity: Amount to trade. Returns: Summary of the arbitrage result.

必填参数:symbol、quantity

find_arbitrage_pairs 4 个参数

Find arbitrage pairs based on funding rate, volume, and rate direction stability. Args: min_funding_rate: Minimum funding rate to qualify. min_avg_volume: Minimum 24hr volume in USDT. history_days: How many days of history to analyze. stability_threshold: Minimum proportion of funding rates in same direction. Returns: List of qualifying arbitrage opportunities.

该工具无需必填参数,直接调用即可

服务介绍

Binance MCP Server

这是一个基于MCP (Model Control Protocol) 的币安交易接口服务器起点代码。它提供了一系列基础的币安交易所交互能力,可以作为你开发更复杂交易策略和功能的基础。

功能特性

当前实现的基础功能包括:

  • 实时获取加密货币价格
  • 查询账户资产余额
  • 下单交易(市价单)
  • 查询交易历史
  • 查询当前未完成订单
  • 取消订单
  • 获取资金费率历史
  • 执行对冲套利策略
  • 自动寻找套利机会

这些功能为你开发更高级的交易策略和自动化系统提供了基础构建块。你可以基于这些接口:

  • 开发更复杂的交易策略
  • 添加风险管理系统
  • 实现更多类型的订单支持
  • 扩展数据分析能力
  • 添加自定义的套利策略

安装要求

  • Python >= 3.13
  • mcp[cli] >= 1.6.0
  • requests >= 2.32.3

安装和配置

  1. 克隆仓库:
git clone https://github.com/mixuechu/binance-mcp.git
cd binance-mcp-server
  1. 创建并激活虚拟环境

  2. 安装依赖:
    uv sync

  3. 配置MCP:
    在你的MCP配置文件中(通常位于 ~/.cursor/mcp.json)添加以下配置:

{
  "binance-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/binance-mcp-server",
      "run",
      "binance.py",
      "--binance-api-key",
      "YOUR_API_KEY",
      "--binance-secret-key",
      "YOUR_SECRET_KEY"
    ]
  }
}

使用方法

  1. 确保你已经在币安创建了API密钥,并在MCP配置文件中正确配置。

  2. 通过MCP客户端调用服务提供的功能:

  • get_symbol_price: 获取某个交易对的当前价格
  • get_account_balance: 查询特定加密货币的账户余额
  • place_market_order: 下市价单
  • get_trade_history: 获取交易历史
  • get_open_orders: 查询未完成订单
  • cancel_order: 取消订单
  • get_funding_rate_history: 获取资金费率历史
  • execute_hedge_arbitrage_strategy: 执行对冲套利策略
  • find_arbitrage_pairs: 寻找套利机会

开发和扩展

这个项目提供了基础的交易功能框架,你可以:

  1. 添加新的交易策略
  2. 扩展现有功能
  3. 添加更多的错误处理和日志
  4. 实现更复杂的套利逻辑
  5. 集成其他交易所的API

安全提示

  • 请妥善保管你的API密钥和密钥
  • 建议在使用时设置适当的API权限限制
  • 在进行实际交易前,建议先在测试网络上进行测试

贡献

欢迎提交问题和合并请求。这个项目处于积极开发中,我们欢迎任何形式的贡献。

许可证

MIT