币安-mcp

Name: 币安-mcp
Author: TermiX-official

作者：TermiX-official64 星标更新：2025-04-16

安装使用来源：spider==github.com

项目介绍

Binance MCP Server

概述

Binance MCP Server 是一个后端服务，旨在与 Binance API 进行交互。它简化了与 Binance 交易所的互动，使用户能够查看他们的投资组合、转换代币并执行交易，同时尽量减少市场影响。该服务器利用模型上下文协议（MCP）框架来确保安全、结构化且高效的交易。

主要功能：

与 Binance 交易所 API 交互以获取账户信息和进行交易
显示投资组合构成和估值
执行智能代币转换以减轻市场影响
处理市价订单和算法交易策略
获取实时交易数据和账户信息
使用模型上下文协议框架实现结构化交易
提供安全的身份验证和 API 密钥管理以集成 Binance

特性

要求

在设置 Binance MCP Server 之前，请确保安装以下内容：

Node.js（v16 或更高版本）
npm 或 yarn
Binance API 密钥和密钥（用于 Binance 交易所集成）
有效的 Binance 智能链（BSC）钱包私钥（用于区块链交易）

安装

克隆仓库并安装依赖项：

git clone https://github.com/your-repo/binance-mcp-server.git
cd binance-mcp-server
npm install  # 或者 yarn install

配置

为了配置服务器，在根目录创建一个 .env 文件，并指定以下变量：

# Binance API 配置
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here

创建 Binance API 密钥

在使用 Binance API 集成之前，您需要创建一个 API 密钥。这允许您通过多种编程语言连接到 Binance 的服务器，从 Binance 获取数据并与外部应用程序交互。您可以查看您的钱包和交易数据，进行交易，并在第三方程序中存取资金。

前提条件：

您需要向您的现货钱包存入任意金额以激活账户
完成身份验证
在您的账户上启用双因素认证（2FA）

创建 Binance API 密钥的步骤：

登录到您的 Binance 账户，点击个人资料图标，然后选择 [账户]。
前往 [API 管理] 并点击 [创建 API]。
选择您偏好的 API 密钥类型：
- 系统生成的 API 密钥（HMAC 对称加密）- 您将获得 API 密钥和密钥。
- 自行生成的 API 密钥（Ed25519 或 RSA 非对称加密）- 您将收到一个 API 密钥，但需要自己创建公私钥对。
输入您的 API 密钥标签/名称。
使用您的 2FA 设备和通行密钥进行验证。
您的 API 密钥现在已创建。

有关 Binance API 的更多详情，请参阅 Binance API 文档。

与 Claude Desktop 集成

在将此 MCP 服务器与 Claude Desktop 集成之前，请确保安装以下内容：

Claude Desktop

然后使用以下命令构建服务器：

npm run build

要将此 MCP 服务器添加到 Claude Desktop：

在以下位置创建或编辑 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
    "mcpServers": {
        "binance-mcp": {
            "command": "node",
            "args": [
                "/Users/Username/Desktop/binance-mcp/build/index.js"
            ],
            "env": {
                "BINANCE_API_KEY": "BINANCE_API_KEY",
                "BINANCE_API_SECRET": "BINANCE_API_SECRET"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

确保在 args 字段中传递正确的 index.js 文件位置。

重启 Claude Desktop 以使更改生效。

使用方法（连接其他 MCP HOST）

启动服务器

要启动 MCP 服务器，请运行：

npm start  # 或者 node index.js

功能

Binance API 函数

获取 Binance 账户信息 - binanceAccountInfo

获取关于您的 Binance 账户的综合信息，包括余额、交易权限和账户状态。
获取 Binance 账户快照 - binanceAccountSnapshot

获取您的 Binance 账户状态的快照，包括当前 BTC 价格信息。包括过去 30 天的历史记录。
检查 Binance 订单簿 - binanceOrderBook
```
{
    "symbol": "BTCUSDT"
}
```
获取指定交易对的当前订单簿，显示可用的买单和卖单，最多 50 层深。
下单现货市场订单 - binanceSpotPlaceOrder
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 0.001,
    // 或者
    "quoteOrderQty": 100
}
```
下单现货市场订单以最佳可用价格立即执行。使用 quantity 指定基础资产的数量或使用 quoteOrderQty 指定报价货币的数量。适用于小额订单。
下单 TWAP 订单 - binanceTimeWeightedAveragePriceFutureAlgo
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 1.0,
    "duration": 3600
}
```
下单时间加权平均价格（TWAP）订单，该订单将在指定的时间内逐渐执行，以最小化市场影响。适用于可能引起显著价格变动的大额订单。

模型上下文协议（MCP）

模型上下文协议（MCP） 是一种开放标准，旨在改进应用程序与 AI 模型和基于区块链的计算系统之间的交互方式。MCP 建立了结构化的上下文，提高了自动化交易和去中心化应用的效率。

MCP 的优势：

标准化：定义了一种统一的应用程序交互方法。
效率：减少了计算开销并提高了交易速度。
互操作性：支持跨多个平台和区块链生态系统的集成。

错误处理

当交易失败时，服务器会返回带有详细信息的错误消息。查看控制台日志以获取更多调试信息。常见的错误场景包括：

钱包中的资金不足
收件人地址无效
网络拥堵或 RPC 问题
Binance API 认证错误
交易限额限制

许可证

本项目在 MIT 许可证下开源。

对于贡献、错误报告或功能请求，请在 GitHub 上提交问题。