币安MCP服务器

概述

币安MCP服务器是一项后端服务，旨在与币安API交互。它促进了与币安交易平台的无缝交互，使用户能够查看其投资组合、兑换代币并在最大程度上降低市场影响的情况下执行交易。该服务器利用模型上下文协议 (MCP) 框架来确保交易的安全、结构化和高效。

主要功能：

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

特征

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

要求

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

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

安装

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

配置

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

创建币安 API 密钥

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

先决条件：

• 您需要向您的现货钱包存入任意金额才能激活您的帐户
• 完成身份验证
• 在您的帐户上启用双因素身份验证 (2FA)

创建币安 API 密钥的步骤：

1. 登录您的币安账户，点击个人资料图标，然后点击[账户]。
2. 进入【API管理】，点击【创建API】。
3. 选择您喜欢的 API 密钥类型：
   • 系统生成的 API 密钥（HMAC 对称加密） - 您将获得 API 密钥和密钥。
   • 自生成的 API 密钥（Ed25519 或 RSA 非对称加密） - 您将收到一个 API 密钥，但您必须创建自己的公钥-私钥对。
4. 输入您的 API 密钥的标签/名称。
5. 使用您的 2FA 设备和密钥进行验证。
6. 您的 API 密钥现已创建。

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

与 Claude Desktop 集成

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

• 克劳德桌面

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

要将此 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

添加以下配置：

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

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

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

启动服务器

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

功能

币安 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上提交问题。