项目简介

这是一个基于 Model Context Protocol (MCP) 实现的服务器，专门用于与币安 (Binance) 加密货币交易平台进行交互。它允许 AI 代理或其他兼容 MCP 的客户端通过标准化的接口访问币安的各项功能，如获取市场数据、执行交易、管理账户等。

主要功能点

• 安全认证: 使用币安 API 密钥进行身份验证。
• 实时市场数据: 获取实时价格、订单簿、市场统计等数据。
• 交易操作: 支持下达、修改、取消各种类型的订单。
• 投资组合管理: 查看账户余额、持仓信息和盈亏分析。
• 丰富的工具集: 提供共计 26 个覆盖账户、市场、交易、风控等方面功能的工具。

安装步骤

该服务器可以通过 Python 包管理器安装。推荐使用 'uv'，也可以使用 'pip'。

# 推荐使用 uv
uv add binance-mcp-server

# 或者使用 pip
pip install binance-mcp-server

安装完成后，您需要设置您的币安 API 密钥和 Secret。最安全的方式是通过环境变量：

export BINANCE_API_KEY="您的币安 API 密钥"
export BINANCE_API_SECRET="您的币安 API Secret"

# 如果需要使用测试网 (推荐开发时使用)
export BINANCE_TESTNET="true" 

服务器配置

MCP 客户端（如 AI 代理）需要配置如何启动并连接到这个 MCP 服务器。通常，这涉及在客户端的配置中提供服务器的启动命令 ('command') 和必要的参数 ('args')。

对于 Binance MCP 服务器，配置信息应包含：

• 服务器名称: 您可以为服务器指定一个名称，例如 'binance'。
• 启动命令: 指定执行文件的名称，即 'binance_mcp_server'。
• 启动参数: 提供必要的命令行参数，例如：
  • '--api-key': 您的币安 API 密钥。
  • '--api-secret': 您的币安 API Secret。
  • '--binance-testnet': 一个布尔值，'true' 表示使用币安测试网，'false' 表示使用主网。

这些参数需要根据您的 MCP 客户端的要求，以 JSON 格式嵌入到客户端的配置文件中。客户端会根据此配置启动服务器进程并通过标准输入/输出来通信。

基本使用方法

一旦 MCP 客户端成功连接到 Binance MCP 服务器，它就可以通过发送符合 JSON-RPC 规范的请求来调用服务器提供的工具。每个请求通常包含要调用的工具名称及其参数。

例如，MCP 客户端可以发送请求来：

• 获取特定交易对（如 BTCUSDT）的当前价格，调用 'get_ticker_price' 工具并提供 'symbol' 参数。
• 查询账户余额，调用 'get_balance' 工具并提供 'account_type' 参数。
• 下达一个限价买单，调用 'place_order' 工具并提供 'symbol', 'side', 'type', 'quantity', 'price' 等参数。

服务器将处理这些请求，与币安 API 交互，并将结果以 JSON-RPC 响应的形式返回给客户端。