MCP 服务器

Binance MCP Server

一个后端服务，用于与币安交易所 API 进行交互，使用户能够查看其投资组合、转换代币并执行交易，同时最大限度地减少对市场的影响。

README

Binance MCP 服务器

概述

Binance MCP 服务器是一个后端服务，旨在与 Binance API 交互。它促进与 Binance 交易所的无缝交互，使用户能够查看其投资组合、转换代币并执行交易，同时最大限度地减少市场影响。该服务器利用模型上下文协议 (MCP) 框架来确保安全、结构化和高效的交易。

主要功能：

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

特性

[x] Binance API 集成：连接到 Binance 交易所，进行账户信息查询和交易操作
[x] 投资组合管理：查看详细的投资组合构成、市值和百分比分配
[x] 投资组合分析：可选的历史价值跟踪，以监控一段时间内的表现
[x] 智能代币转换：使用智能订单执行策略在代币之间进行转换
[x] 市场影响缓解：自动使用算法交易处理较大订单，以防止价格滑点
[x] 账户管理：检索详细的账户信息、余额和交易历史记录
[x] 市场数据访问：访问实时订单簿和市场数据，以便做出明智的交易决策
[x] 订单执行：以灵活的数量规范下达现货市场订单
[ ] 算法交易支持：实施时间加权平均价格 (TWAP) 订单，以最大限度地减少市场影响
[ ] 自动化交易：根据预定义的策略以编程方式执行交易
[ ] 安全身份验证：管理 API 密钥并建立与 Binance 服务的安全连接
[ ] 全面的错误处理：针对交易失败和 API 问题提供详细的错误报告

要求

在设置 Binance MCP 服务器之前，请确保已安装以下组件：

Node.js (v16 或更高版本)
npm 或 yarn
Binance API 密钥和密钥 (用于 Binance 交易所集成)
有效的 Binance Smart Chain (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 以使更改生效。

用法（用于连接 Claude 以外的 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,
    // OR
    "quoteOrderQty": 100
}
```
下达市价单，以便以最佳可用价格立即执行。使用 quantity 指定基础资产的数量，或使用 quoteOrderQty 指定报价货币的数量。适用于小额订单。
下达 TWAP 订单 - binanceTimeWeightedAveragePriceFutureAlgo
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 1.0,
    "duration": 3600
}
```
下达时间加权平均价格 (TWAP) 订单，该订单在指定时间内逐步执行，以最大限度地减少市场影响。适用于可能导致显着价格变动的大额订单。