🚀 MCP Bitget交易服务器
MCP（模型上下文协议）服务器用于Bitget加密货币交易所。它使AI助手能够与Bitget API进行交互，以进行现货和期货交易。具备实时市场数据、订单管理、账户余额查询、杠杆控制和持仓跟踪等功能，还支持模拟交易模式。
🚀 快速开始
前提条件
- Node.js 18+
- npm 或 yarn
- Bitget API 凭证（用于实盘/模拟交易）
快速上手
- 克隆仓库
git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading
- 安装依赖
npm install
- 配置环境
cp .env.example .env
# 使用你的Bitget API凭证编辑.env文件
- 构建项目
npm run build
- 启动服务器
npm start
✨ 主要特性
📊 市场数据
- 实时价格 - 获取任何交易对的当前市场价格
- 完整行情 - 包含24小时统计信息的完整行情信息
- 订单簿 - 可配置深度级别的市场深度数据
- 历史K线 - 用于技术分析的OHLCV数据
💰 账户管理
- 余额信息 - 所有资产的实时账户余额
- 持仓跟踪 - 监控当前期货持仓
- 保证金信息 - 期货保证金账户详情
- 订单管理 - 查看和管理未成交订单
🎯 交易操作
- 下单 - 执行市价单和限价单
- 撤单 - 按ID取消现有订单
- 杠杆控制 - 设置期货持仓的杠杆（1 - 125倍）
- 模拟交易 - 完全支持模拟交易模式
⚡ 技术特性
- TypeScript - 全类型化实现
- v2 API 支持 - 集成最新的Bitget API
- 速率限制 - 内置防止API限制的保护机制
- 错误处理 - 全面的错误管理
- Zod验证 - 对所有参数进行输入验证
📦 安装指南
前提条件
- Node.js 18+
- npm 或 yarn
- Bitget API 凭证（用于实盘/模拟交易）
快速开始
- 克隆仓库
git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading
- 安装依赖
npm install
- 配置环境
cp .env.example .env
# 使用你的Bitget API凭证编辑.env文件
- 构建项目
npm run build
- 启动服务器
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({})
📚 详细文档
可用工具
市场数据工具
| 工具 | 描述 | 参数 |
|---|---|---|
getPrice |
获取当前价格 | symbol: string |
getTicker |
获取完整行情信息 | symbol: string |
getOrderBook |
获取订单簿 | symbol: string, depth?: number |
getCandles |
获取OHLCV数据 | symbol: string, interval: string, limit?: number |
账户工具
| 工具 | 描述 | 参数 |
|---|---|---|
getBalance |
获取账户余额 | asset?: string |
getPositions |
获取期货持仓 | symbol?: string |
getMarginInfo |
获取保证金信息 | symbol?: string |
getOrders |
获取未成交订单 | symbol?: string, status?: string |
交易工具
| 工具 | 描述 | 参数 |
|---|---|---|
placeOrder |
下单 | symbol, side, type, quantity, price? |
cancelOrder |
撤单 | orderId: string, symbol: string |
setLeverage |
设置杠杆 | symbol: string, leverage: number |
符号格式
现货交易
- 格式：
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模式进行验证
故障排除
常见问题
-
错误 40009 - 签名错误
- 检查API密钥配置
- 确保时间戳同步
-
错误 40099 - 交易所环境错误
- 验证模拟/实盘模式设置
- 检查模拟模式的
paptrading头部
-
错误 400172 - 参数验证失败
- 检查必填参数
- 验证符号格式
贡献
- 分叉仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
本项目采用MIT许可证，详情请参阅 LICENSE 文件。
免责声明
本软件仅用于教育和开发目的。使用时请自行承担风险。在进行实盘交易之前，请务必先在模拟模式下进行测试。作者对任何财务损失不承担责任。
资源
支持
- 问题反馈：GitHub Issues
- 讨论交流：GitHub Discussions
为加密交易社区用心打造 ❤️