项目简介

Binance MCP Server 是一个 MCP 服务器的实现,它允许用户通过 Claude Desktop 等 MCP 客户端,安全便捷地访问币安交易所的 API。该服务器封装了币安 API 的常用功能,如账户信息查询、订单簿查看和交易下单等,并以结构化的方式提供给 LLM 应用,从而实现更智能的交易和投资辅助功能。

主要功能点

  • 币安 API 集成: 连接币安交易所 API,支持账户信息查询和交易操作。
  • 账户管理: 查询币安账户的详细信息,包括余额、交易记录等。
  • 市场数据: 获取实时的订单簿数据,辅助交易决策。
  • 现货交易: 支持现货市场交易下单,包括市价单和 TWAP 算法订单,以适应不同大小的交易需求。
  • 投资组合管理: 查看投资组合构成和估值,可选的历史价值跟踪功能帮助监控投资表现。
  • 智能 token 兑换: 支持 token 之间的智能兑换,并具备市场冲击缓解功能,尤其适合大额交易。
  • 安全认证: 通过 API 密钥管理和安全连接,保障用户币安账户的安全。

安装步骤

  1. 克隆仓库

    git clone https://github.com/TermiX-official/binance-mcp.git
    cd binance-mcp
  2. 安装依赖

    npm install # 或 yarn install
  3. 配置环境变量

    在项目根目录下创建 '.env' 文件,并填入您的币安 API 密钥和密钥:

    BINANCE_API_KEY=your_binance_api_key_here
    BINANCE_API_SECRET=your_binance_api_secret_here

    注意: 请务必在币安官网创建 API 密钥,并妥善保管。API 密钥的创建步骤请参考仓库 README.md 文档。

  4. 构建项目

    npm run build

服务器配置

要将 Binance MCP Server 添加到 Claude Desktop 等 MCP 客户端,您需要配置 MCP 服务器的启动命令。以下是 Claude Desktop 的配置示例,其他 MCP 客户端的配置方式类似:

编辑 Claude Desktop 的配置文件 'claude_desktop_config.json' (文件路径请参考仓库 README.md 文档),在 'mcpServers' 字段中添加以下配置:

{
    "mcpServers": {
        "binance-mcp": {
            "command": "node",
            "args": [
                "/path/to/binance-mcp/build/index.js"  //  请替换为您的 binance-mcp 项目 build 目录下 index.js 文件的绝对路径
            ],
            "env": {
                "BINANCE_API_KEY": "您的币安 API Key",   //  请替换为您的币安 API Key
                "BINANCE_API_SECRET": "您的币安 API Secret"  //  请替换为您的币安 API Secret
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

配置参数说明:

  • server name: 'binance-mcp' (服务器名称,在 Claude Desktop 中用于标识和选择)
  • command: 'node' (启动服务器的命令,这里使用 Node.js)
  • args: '["/path/to/binance-mcp/build/index.js"]' (启动命令的参数,指向编译后的 'index.js' 文件路径。请务必替换为您的实际路径)
  • env: 环境变量配置,用于传递 API 密钥等敏感信息。
    • 'BINANCE_API_KEY': 您的币安 API Key
    • 'BINANCE_API_SECRET': 您的币安 API Secret
  • disabled: 'false' (设置为 'false' 表示启用该服务器)
  • autoApprove: '[]' (自动批准的工具列表,默认为空,表示需要手动批准工具调用)

配置完成后,重启 Claude Desktop 使配置生效。

基本使用方法

  1. 启动服务器

    在项目根目录下,运行以下命令启动 MCP 服务器:

    npm start # 或 node build/index.js
  2. 在 MCP 客户端中使用

    在 Claude Desktop 等 MCP 客户端中,选择配置中定义的服务器名称 ('binance-mcp'),即可开始使用 Binance MCP Server 提供的功能。

    您可以通过客户端提供的界面或指令,调用服务器提供的工具,例如:

    • 使用 'binanceAccountInfo' 工具查询币安账户信息。
    • 使用 'binanceOrderBook' 工具查看指定交易对的订单簿。
    • 使用 'binanceSpotPlaceOrder' 或 'binanceTimeWeightedAveragePriceFutureAlgo' 工具进行现货交易下单。

    具体工具的使用方法和参数,请参考仓库 README.md 文档中 "Functions" 章节的说明。

信息

分类

商业系统