Binance MCP

🚀 Binance MCP 服务器使用说明

本项目是 Binance MCP 服务器的使用说明文档，旨在帮助用户完成服务器的安装、配置和使用，同时提供错误处理、安全提示等方面的指导。

🚀 快速开始

若要使用 Binance MCP 服务器，你可以按照以下步骤进行操作：

1. 下载源码。
2. 安装依赖项。
3. 启动服务器。

📦 安装指南

下载源码

git clone https://github.com/yourusername/binance-mcp-server.git
cd binance-mcp-server

安装依赖项

在项目根目录运行以下命令：

npm install

启动服务器

设置环境变量后启动：

node build/index.js

🛠️ 配置指南

环境变量配置

创建一个 .env 文件并添加以下内容：

BINANCE_API_KEY=your_api_key
BINANCE_API_SECRET=your_api_secret

启动脚本修改

将启动命令添加到 package.json 的 scripts 部分：

{
  "scripts": {
    "start": "set BINANCE_API_KEY=your_api_key & set BINANCE_API_SECRET=your_api_secret & node build/index.js",
    ...
  }
}

✨ 主要特性

账户信息查询

使用 get_account 命令获取账户详情：

node index.js get_account

资产列表查询

列出所有可交易资产：

node index.js list_assets

市场数据获取

通过 market_data 模块获取实时市场信息，例如：

node index.js market_data --symbol=BTCUSDT

订单操作

查看未完成订单

node index.js get_orders --symbol=BTCUSDT

取消订单

node index.js cancel_order --order_id=12345

执行撤单

node index.js place_order --symbol=BTCUSDT --side=sell --quantity=0.01 --type=market

💻 使用示例

基础用法

const { BinanceMcpServer } = require('binance-mcp-server');

async function main() {
    const server = new BinanceMcpServer({
        apiKey: process.env.BINANCE_API_KEY,
        apiSecret: process.env.BINANCE_API_SECRET
    });

    await server.start();
}

main().catch(err => console.error(err));

⚠️ 错误处理

常见错误

1. 环境变量未设置

BINANCE_API_KEY 和 BINANCE_API_SECRET 环境变量是必需的。

2. API 请求失败

• 问题： API 返回错误码 403（权限不足）
• 解决方法： 检查 API 密钥权限设置

3. 网络连接问题

• 原因： 不稳定的互联网连接或 Binance 服务器限制
• 解决方案： 使用 VPN 或检查 IP 地址是否被允许访问

🔒 安全提示

API Key 管理

• 隐私保护： 避免直接在代码中硬编码 API 密钥，建议使用环境变量或专业密钥管理工具。
• 权限控制： 为 API 密钥设置最小必要的权限范围。
• IP 白名单： 在 Binance 账户设置中启用 IP 限制。

安全警告

• 避免在公共网络中传输敏感信息。
• 定期更新 API 密钥并撤销旧密钥。

🚀 部署选项

开发环境部署

1. 克隆仓库

git clone https://github.com/yourusername/binance-mcp-server.git
cd binance-mcp-server

2. 安装依赖

npm install

3. 启动服务

node build/index.js

生产环境部署

1. 构建优化

npm run build

2. 配置环境变量

export BINANCE_API_KEY=your_api_key
export BINANCE_API_SECRET=your_api_secret

3. 启动服务

node build/index.js start --production

📚 详细文档

兼容性说明

• 支持 Node.js 版本：>=14.0.0

错误码参考

维护指南

• 定期检查 API 文档更新。
• 更新依赖包至最新版本。
• 监控服务器日志。

📞 联系方式

如需帮助或报告问题，请联系：support@binance.com