AI导哈

币安API服务

Binance MCP Server是一个后端服务，用于与Binance API交互，提供投资组合管理、智能代币转换和交易执行功能。

  • by TermiX-official
  • TypeScript
  • 本地部署
  • 97 星标
  • 更新于
在 GitHub 查看 TermiX-official/binance-mcp

使用说明

币安MCP服务器

概述

Binance MCP服务器是一种后端服务，旨在与Binance API进行交互。它促进了与币安交易所的无缝交互，使用户能够查看他们的投资组合，转换代币，并以最小的市场影响执行交易。服务器利用模型上下文协议（MCP）框架来确保安全、结构化和高效的事务。

关键功能：

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

特性

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

需求

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

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

安装

克隆存储库并安装依赖项：

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

配置

要配置服务器，请创建 .env 在根目录中创建文件，并指定以下变量：

# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here

创建Binance API密钥

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

先决条件：

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

创建Binance API密钥的步骤：

  1. 登录您的币安账户，点击个人资料图标，然后点击[账户]。

  2. 转到[API管理]，然后单击[创建API]。

  3. 选择您首选的API密钥类型：

    • 系统生成的API密钥（HMAC对称加密）-您将获得API密钥和密钥。
    • 自生成API密钥（Ed25519或RSA非对称加密）-您将收到一个API密钥，但您必须创建自己的公私密钥对。

  4. 输入API密钥的标签/名称。

  5. 使用您的2FA设备和密钥进行验证。

  6. 您的API密钥现在已创建。

有关Binance API的更多详细信息，请参阅 币安API文档.

与Claude Desktop集成

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

  • 克劳德桌面

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

npm run build

要将此MCP服务器添加到Claude Desktop，请执行以下操作：

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

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %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": []
        }
    }
}

确保通过正确的位置 index.js 文件在 args 现场。

重新启动Claude Desktop以使更改生效。

用法（用于连接除Claude之外的MCP主机）

启动服务器

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

npm start  # or node index.js

函数

币安API函数

  1. 获取币安账户信息- binanceAccountInfo

    检索有关您的币安帐户的全面信息，包括余额、交易权限和帐户状态。

  2. 获取币安账户快照- binanceAccountSnapshot

    获取您的币安账户状态的快照，包括当前的BTC价格信息。包括过去30天的历史记录。

  3. 查看币安订单簿- binanceOrderBook

    {
    "symbol": "BTCUSDT"
}

    检索指定交易对的当前订单簿，显示高达50个级别的可用买入和卖出订单。

  4. 下达现货市场订单- binanceSpotPlaceOrder

    {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 0.001,
    // OR
    "quoteOrderQty": 100
}

    下达市价单，以最优惠的价格立即执行。使用 quantity 指定基础资产的金额或 quoteOrderQty 以报价货币指定金额。适合小订单。

  5. 下TWAP订单- binanceTimeWeightedAveragePriceFutureAlgo

    {
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 1.0,
    "duration": 3600
}

    下达时间加权平均价格（TWAP）订单，在指定的持续时间内逐步执行，以尽量减少市场影响。适用于可能导致价格大幅波动的大订单。

模型上下文协议（MCP）

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

MCP的好处：

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

错误处理

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

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

许可证

该项目在MIT许可证下是开源的。

对于贡献、错误报告或功能请求，请在以下网址提交问题 GitHub.

相关 MCP