MCP Bitget Trading

🚀 MCP Bitget交易服务器

MCP（模型上下文协议）服务器用于Bitget加密货币交易所。它使AI助手能够与Bitget API进行交互，以进行现货和期货交易。具备实时市场数据、订单管理、账户余额查询、杠杆控制和持仓跟踪等功能，还支持模拟交易模式。

🚀 快速开始

前提条件

• Node.js 18+
• npm 或 yarn
• Bitget API 凭证（用于实盘/模拟交易）

快速上手

1. 克隆仓库

git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading

2. 安装依赖

npm install

3. 配置环境

cp .env.example .env
# 使用你的Bitget API凭证编辑.env文件

4. 构建项目

npm run build

5. 启动服务器

npm start

✨ 主要特性

📊 市场数据

• 实时价格 - 获取任何交易对的当前市场价格
• 完整行情 - 包含24小时统计信息的完整行情信息
• 订单簿 - 可配置深度级别的市场深度数据
• 历史K线 - 用于技术分析的OHLCV数据

💰 账户管理

• 余额信息 - 所有资产的实时账户余额
• 持仓跟踪 - 监控当前期货持仓
• 保证金信息 - 期货保证金账户详情
• 订单管理 - 查看和管理未成交订单

🎯 交易操作

• 下单 - 执行市价单和限价单
• 撤单 - 按ID取消现有订单
• 杠杆控制 - 设置期货持仓的杠杆（1 - 125倍）
• 模拟交易 - 完全支持模拟交易模式

⚡ 技术特性

• TypeScript - 全类型化实现
• v2 API 支持 - 集成最新的Bitget API
• 速率限制 - 内置防止API限制的保护机制
• 错误处理 - 全面的错误管理
• Zod验证 - 对所有参数进行输入验证

📦 安装指南

前提条件

• Node.js 18+
• npm 或 yarn
• Bitget API 凭证（用于实盘/模拟交易）

快速开始

1. 克隆仓库

git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading

2. 安装依赖

npm install

3. 配置环境

cp .env.example .env
# 使用你的Bitget API凭证编辑.env文件

4. 构建项目

npm run build

5. 启动服务器

npm start

🔧 技术细节

环境变量

在根目录下创建一个 .env 文件：

# Bitget API 配置
BITGET_API_KEY=your_api_key_here
BITGET_SECRET_KEY=your_secret_key_here
BITGET_PASSPHRASE=your_passphrase_here

# 环境设置
BITGET_SANDBOX=true  # 设置为true以进行模拟交易
BITGET_BASE_URL=https://api.bitget.com
BITGET_WS_URL=wss://wspap.bitget.com/v2/ws/public

# 可选设置
LOG_LEVEL=info
RATE_LIMIT_REQUESTS_PER_SECOND=10

Claude桌面集成

添加到你的Claude桌面MCP设置（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "bitget-trading": {
      "command": "node",
      "args": ["/path/to/MCP-bitget-trading/dist/server.js"],
      "env": {
        "BITGET_API_KEY": "your_key",
        "BITGET_SECRET_KEY": "your_secret",
        "BITGET_PASSPHRASE": "your_passphrase",
        "BITGET_SANDBOX": "true"
      }
    }
  }
}

💻 使用示例

基础用法

// 获取当前比特币价格
await getPrice({ symbol: "BTCUSDT" })

// 获取期货价格
await getPrice({ symbol: "BTCUSDT_UMCBL" })

高级用法

// 下一个限价买单
await placeOrder({
  symbol: "BTCUSDT",
  side: "buy",
  type: "limit",
  quantity: "0.001",
  price: "50000"
})

// 设置期货杠杆
await setLeverage({
  symbol: "BTCUSDT_UMCBL",
  leverage: 10
})

// 查看余额
await getBalance({ asset: "USDT" })

// 获取所有持仓
await getPositions({})

📚 详细文档

可用工具

市场数据工具

账户工具

交易工具

符号格式

现货交易

• 格式：BTCUSDT、ETHUSDT、ADAUSDT
• 无需后缀

期货交易

• 格式：BTCUSDT_UMCBL、ETHUSDT_UMCBL
• USDT保证金合约使用 _UMCBL 后缀

开发

脚本

npm run dev      # 开发模式，支持热重载
npm run build    # 生产环境构建
npm run test     # 运行测试
npm run lint     # 代码检查
npm run format   # 代码格式化

项目结构

src/
├── api/
│   └── rest-client.ts    # Bitget REST API 客户端
├── types/
│   ├── bitget.ts         # Bitget API 类型
│   └── mcp.ts           # MCP 模式定义
└── server.ts            # 主MCP服务器

安全

• API密钥：存储在环境变量中，切勿提交到代码库
• 模拟模式：使用 BITGET_SANDBOX=true 进行模拟交易
• 速率限制：内置保护机制（默认每秒10个请求）
• 验证：所有输入都使用Zod模式进行验证

故障排除

常见问题

1. 错误 40009 - 签名错误

   • 检查API密钥配置
   • 确保时间戳同步

2. 错误 40099 - 交易所环境错误

   • 验证模拟/实盘模式设置
   • 检查模拟模式的 paptrading 头部

3. 错误 400172 - 参数验证失败

   • 检查必填参数
   • 验证符号格式

贡献

1. 分叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

免责声明

本软件仅用于教育和开发目的。使用时请自行承担风险。在进行实盘交易之前，请务必先在模拟模式下进行测试。作者对任何财务损失不承担责任。

资源

• Bitget API 文档
• 模型上下文协议
• Claude桌面版

支持

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions

为加密交易社区用心打造 ❤️