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