Binance MCP Server 🚀

Binance MCP 服务 🚀

强大的模型上下文协议（MCP）服务，让 AI Agent 能够与 Binance 加密货币交易所无缝交互。此服务通过标准化的 MCP 接口提供全面的交易工具、市场数据访问和账户管理功能。

🌟 这是什么？

此工具充当AI 助手（如 Claude、Cursor AI 或 ChatGPT）与您的 Binance 账户之间的桥梁。

您无需手动浏览 Binance 网站或应用，只需向 AI 提出以下请求：

• “查询 Bitcoin 的当前价格”
• “显示我的账户余额”
• “按当前市场价格购买 0.1 ETH”

AI 会将请求发送到此服务，由它在 Binance 上安全地执行操作，并将结果返回给 AI。

🚀 快速开始

1️⃣ 安装

最简单的安装方式是使用 pip 或 uv：

# using pip
pip install binance-mcp-server
# using uv
uv add binance-mcp-server

2️⃣ 配置

您需要使用 Binance API 密钥，以允许此工具访问您的账户。

1. 登录 Binance 账户并前往 API 管理。
2. 创建新的 API 密钥。
3. 在终端中将密钥设置为环境变量：

# Required: Your Binance API credentials
export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"

# Recommended: Use testnet for development and safe testing
export BINANCE_TESTNET="true"

3️⃣ 与 AI 配合运行

为 Claude Desktop / VSCode / Cursor 配置

将以下内容添加到 MCP 设置配置文件中（例如 claude_desktop_config.json 或 mcp_config.json）：

{
  "mcpServers": {
    "binance": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key", "your_api_key",
        "--api-secret", "your_secret",
        "--binance-testnet"
      ]
    }
  }
}

🎯 主要功能

• 实时市场数据：获取实时价格、订单簿和行情统计数据。
• 账户管理：检查余额和账户状态。
• 交易操作：下达买入／卖出订单（市价单、限价单等）。
• 投资组合跟踪：监控未平仓头寸及盈亏（PnL）。

📚 技术参考

可用工具

点击展开完整工具列表

🏦 账户与投资组合管理

工具	用途
get_balance	获取所有资产的账户余额
get_account_snapshot	获取某一时点的账户状态快照
get_fee_info	交易费率（挂单方／吃单方手续费）
get_available_assets	列出所有可交易的加密货币

📊 市场数据与分析

工具	用途
get_ticker_price	获取交易标的的当前价格
get_ticker	24 小时行情价格变动统计
get_order_book	当前订单簿（买单／卖单）

💱 交易操作

工具	用途
create_order	创建买入／卖出订单（市价单、限价单等）
get_orders	列出指定交易标的的订单历史

📈 表现与分析

工具	用途
get_pnl	计算期货交易的盈亏
get_position_info	查看未平仓期货头寸详情

🏪 钱包与转账

工具	用途
get_deposit_address	获取指定币种的充值地址
get_deposit_history	查看指定币种的充值历史
get_withdraw_history	查看指定币种的提现历史

🛡️ 风险管理

工具	用途
get_liquidation_history	期货的历史强平事件

配置变量

变量	描述	必填	默认值
BINANCE_API_KEY	您的 Binance API 密钥	✅	-
BINANCE_API_SECRET	您的 Binance API 密钥密文	✅	-
BINANCE_TESTNET	使用测试网环境	❌	false

🛠️ 开发与贡献

欢迎贡献！如果您是希望改进此项目的开发者：

1. 克隆仓库：git clone https://github.com/AnalyticAce/binance-mcp-server.git
2. 安装开发依赖：uv install --dev 或 pip install -e .[dev]
3. 运行测试：pytest

详细指南请参阅 CONTRIBUTING.md。

📄 许可证与免责声明

许可证：MIT

免责声明：本软件仅用于教育目的。加密货币交易涉及财务风险。测试和开发时请务必使用 Binance Testnet。开发者不对任何财务损失负责。