Bybit MCP Server

🚀 Bybit MCP Server

Bybit MCP Server 是一个适用于 Bybit 交易所的模型上下文协议（MCP）服务器，它能让 Claude Code 和 Cursor 等 AI 编码工具与 Bybit 的交易平台进行交互。

🚀 快速开始

📦 安装指南

npm install -g bybit-mcp-server

⚙️ 配置说明

这个 MCP 服务器可以与各种支持 MCP 的 AI 工具一起使用：

Claude Code 配置

测试网（推荐 - 适合测试）： 在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "bybit": {
      "command": "npx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your_testnet_api_key",
        "BYBIT_API_SECRET": "your_testnet_api_secret",
        "BYBIT_ENVIRONMENT": "testnet"
      }
    }
  }
}

主网（⚠️ 警告：使用真实资金）： 在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "bybit": {
      "command": "npx",
      "args": ["bybit-mcp-server"],
      "env": {
        "BYBIT_API_KEY": "your_mainnet_api_key",
        "BYBIT_API_SECRET": "your_mainnet_api_secret",
        "BYBIT_ENVIRONMENT": "mainnet"
      }
    }
  }
}

Cursor 配置

使用与上述 Claude Code 相同的配置，但将其添加到 .cursor/mcp_config.json 中，并使用 mcp.servers 而不是 mcpServers。

🌐 环境设置

选项 1：测试网（推荐）

BYBIT_API_KEY=your_testnet_api_key_here
BYBIT_API_SECRET=your_testnet_api_secret_here
BYBIT_ENVIRONMENT=testnet
DEBUG=false

选项 2：主网（⚠️ 使用真实资金）

BYBIT_API_KEY=your_mainnet_api_key_here
BYBIT_API_SECRET=your_mainnet_api_secret_here
BYBIT_ENVIRONMENT=mainnet
DEBUG=false

🔑 获取 API 密钥

测试网：

1. 访问 Bybit 测试网
2. 注册一个账户
3. 进入 API 管理并创建 API 密钥
4. 启用所需权限（读取、交易）

主网：

1. 访问 Bybit
2. 完成账户验证
3. 进入 API 管理并创建 API 密钥
4. 启用所需权限（读取、交易）
5. 设置 IP 限制以增强安全性

✨ 主要特性

市场数据

• get_price - 获取交易对的当前价格
• get_orderbook - 获取交易对的订单簿深度
• get_klines - 获取历史 K 线数据
• get_24hr_ticker - 获取 24 小时交易统计信息

账户管理

• get_account_info - 获取账户信息和余额
• get_wallet_balance - 获取特定账户类型的钱包余额
• get_open_orders - 获取未成交/活跃订单列表
• get_order_history - 获取历史订单

交易（⚠️ 主网可使用真实资金）

• place_order - 下单
• cancel_order - 取消现有订单
• cancel_all_orders - 取消某个交易对或类别的所有订单

💻 使用示例

你可以向你的 AI 助手提出以下请求：

• "获取 Bybit 上 BTCUSDT 的当前价格"
• "显示 ETHUSDT 50 档的订单簿"
• "查看我的账户余额"
• "以 45000 美元的价格限价买入 0.1 个比特币"
• "取消我所有 BTCUSDT 的未成交订单"
• "获取我最近 20 笔交易的历史记录"

⚠️ 安全说明

⚠️ 重要提示

• 测试网 是默认且推荐的安全环境。
• 主网 操作使用真实资金，请务必谨慎使用。
• API 密钥会自动从错误消息中屏蔽。
• 在使用主网之前，务必在测试网上进行充分测试。
• 在主网进行交易操作时会显示警告信息。

💡 使用建议

• 切勿将 API 密钥提交到版本控制系统。
• 使用环境变量来存储凭证。
• 定期轮换你的 API 密钥。
• 在 Bybit API 设置中使用 IP 限制。

🛠️ 开发说明

npm run build     # 编译 TypeScript
npm run dev       # 开发模式
npm run lint      # 运行代码检查
npm run typecheck # 类型检查
npm run watch     # 监听模式

本地开发

1. 克隆仓库：

git clone https://github.com/your-username/bybit-mcp-server.git
cd bybit-mcp-server

2. 安装依赖：

npm install

3. 设置环境：

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

4. 以开发模式运行：

npm run dev

📋 配置选项

📚 详细文档

本服务器实现了 Bybit 的 V5 API 端点。详细的 API 文档请参考：

• Bybit V5 API 文档
• Bybit API GitHub

🤝 贡献指南

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

📄 许可证

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

🎈 支持与反馈

• 📚 文档
• 🐛 问题反馈
• 💬 讨论交流