AI导哈

币安MCP服务器

一个强大的模型上下文协议（MCP）服务器，使AI代理能够与币安加密货币交易所无缝交互，提供交易工具、市场数据访问和账户管理功能。

  • by AnalyticAce
  • Python
  • 本地部署
  • 50 星标
  • 更新于
在 GitHub 查看 AnalyticAce/binance-mcp-server

使用说明

币安MCP服务器🚀

一个强大的 模型上下文协议（MCP）服务器 使AI代理能够与 币安加密货币交易所该服务器通过标准化的MCP接口提供了一套全面的交易工具、市场数据访问和账户管理功能。

🌟 这是什么？

该工具起到了桥梁的作用 AI助手 （如Claude、Cursor AI或ChatGPT）和您的 币安账户.

您可以要求您的AI执行以下操作，而不是手动浏览币安网站或应用程序：

  • “查看比特币的当前价格”
  • “显示我的账户余额”
  • “以当前市场价格购买0.1 ETH”

AI将请求发送到该服务器，该服务器在币安上安全地执行请求，并将结果返回给您的AI。

🚀 快速开始

1.️⃣ 安装

最简单的安装方法是使用 pip 或 uv:

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

2.️⃣ 配置

你需要你的 币安API密钥 允许此工具访问您的帐户。

  1. 登录您的币安帐户并转到 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跑步

配置克劳德桌面/VCode/光标

将以下内容添加到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）。

📚 技术参考

可用工具

Click to expand full list of tools

🏦 账户和投资组合管理

工具 目的
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 您的币安API密钥 ✅ -
BINANCE_API_SECRET 您的币安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

看 贡献.md 详细指南。

📄 许可与免责声明

许可证：MIT

免责声明：此软件用于教育目的。加密货币交易涉及金融风险。 始终使用币安测试网 用于测试和开发。开发商不对任何经济损失负责。

相关 MCP