返回 MCP 目录
public公开dns本地运行

mcp-server-bn

提供币安现货与合约交易全面集成的MCP服务器

article

README

🚀 mcp-server-cex-bn 服务器

mcp-server-cex-bn 服务器是一款专为 Binance 交易打造的工具,支持订单操作、市场数据获取、资产监控和风险管理等功能,为用户提供便捷、高效、安全的交易体验。

✨ 主要特性

  • 订单操作:支持在 Binance 上创建、查询和取消订单
  • 市场数据:提供实时市场数据获取功能
  • 资产监控:能够查看账户余额及交易详情
  • 风险管理:内置风险控制机制,包括止损和止盈功能

📦 安装指南

使用 Smithery 自动安装

通过 Smithery 自动为 Claude 桌面端安装 Binance 交易服务器:

npx -y @smithery/cli install mcp-server-cex-bn --client claude

手动安装步骤

  1. 克隆仓库到本地
  2. 安装依赖项:
    pnpm install
    
  3. 配置 Binance API 凭证到 .env 文件:
    BINANCE_API_KEY=your_api_key_here
    BINANCE_API_SECRET=your_secret_key_here
    
  4. 构建并启动服务器:
    pnpm build
    pnpm start
    

📚 详细文档

项目结构

.
├── src/
│   ├── index.ts                 # 服务器入口文件
│   ├── services/
│   │   ├── binance.ts          # Binance API 集成模块
│   │   ├── keystore.ts         # API 密钥管理模块
│   │   └── tools.ts            # 交易工具实现模块
│   └── types/
│       ├── binance.ts          # Binance 类型定义
│       └── binance-connector.d.ts  # API 客户端类型定义
├── README.md
├── README_CN.md
├── package.json
├── pnpm-lock.yaml
└── tsconfig.json

开发指南

  1. 环境变量配置: 在根目录下创建 .env 文件,并添加以下内容:
BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_secret_key_here
  1. 依赖安装
pnpm install
  1. 构建服务器
pnpm build
  1. 开发模式(自动重建)
pnpm watch

调试工具

由于 MCP 服务器通过标准输入输出进行通信,调试具有一定挑战性。我们推荐使用 MCP Inspector 进行调试:

pnpm inspector

Inspector 会提供一个访问调试工具的浏览器链接。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端