Binance MCP 服务器使用说明

安装指南

下载源码

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

错误处理

常见错误

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
   

使用示例

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));

注意事项

兼容性说明

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

错误码参考

维护指南

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

联系方式

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