关键词

Binance交易现货交易期货交易自动化交易交易工具

使用说明

项目简介

本项目是一个MCP服务器，旨在通过Model Context Protocol (MCP) 协议，为LLM客户端提供与Binance交易所进行现货和期货交易的功能。它允许LLM应用安全、可扩展地访问Binance的交易API，实现自动化交易策略。

主要功能点

  • 现货交易操作: 支持现货市场限价单和市价单的创建、订单状态查询、撤销订单以及账户余额查询。
  • 期货交易操作: 支持多种期货订单类型（限价、市价、止损、止盈等）的创建和管理，包括杠杆设置、持仓监控、资金费率查询等高级功能。支持单向持仓和对冲持仓模式。
  • 工具集成: 提供了一系列预定义的工具，例如：
    • 'configure_api_keys': 安全配置Binance API 密钥。
    • 'create_spot_order': 创建现货订单。
    • 'cancel_order': 撤销现货订单。
    • 'get_balances': 查询账户余额。
    • 'create_futures_order': 创建期货订单。
    • 'cancel_futures_order': 撤销期货订单。
    • 'get_futures_positions': 查询期货持仓。
    • 'set_futures_leverage': 设置期货杠杆。
    • 'get_funding_rate': 获取期货资金费率。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/kydlikebtc/mcp-server-bn.git
cd mcp-server-bn
  2. 安装依赖： 确保已安装 pnpm。在项目根目录下运行： 
    pnpm install
  3. 配置API密钥： 复制 '.env.example' 文件并重命名为 '.env'。然后在 '.env' 文件中填入你的 Binance API Key 和 API Secret。 
    BINANCE_API_KEY=你的API密钥
BINANCE_API_SECRET=你的API密钥
    注意： 请务必妥善保管API密钥，避免泄露。
  4. 构建项目： 在项目根目录下运行： 
    pnpm build
  5. 启动服务器： 构建成功后，运行以下命令启动 MCP 服务器： 
    pnpm start

服务器配置

对于 MCP 客户端，您需要配置服务器的启动命令以连接到 Binance Spot Trading MCP 服务器。以下是配置信息（JSON 格式）：

{
  "server name": "Binance Spot Trading",
  "command": "pnpm",
  "args": ["start"]
}
  • '"server name"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
  • '"command"': 启动服务器的命令，这里使用 'pnpm'。
  • '"args"': 命令参数，'["start"]' 表示执行 'pnpm start' 启动服务器。

基本使用方法

  1. 在支持 MCP 协议的 LLM 客户端中安装和配置此服务器。 具体安装和配置方法请参考 LLM 客户端的文档。通常需要填入上述服务器配置信息。
  2. 配置API密钥：首次使用交易功能前，需要调用 'configure_api_keys' 工具配置 Binance API 密钥。例如，在客户端中输入指令：'configure_api_keys apiKey:YOUR_API_KEY apiSecret:YOUR_API_SECRET' (请替换 'YOUR_API_KEY' 和 'YOUR_API_SECRET' 为你的实际密钥)。
  3. 使用交易工具：配置 API 密钥后，即可使用其他交易工具，例如创建现货订单：'create_spot_order symbol:BTCUSDT side:BUY type:MARKET quantity:0.001'。 具体的工具名称和参数请参考仓库 'README.md' 文件中 "Tools" 部分的说明。

信息

分类

商业系统

访问项目