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 文件。

🎈 支持與反饋

• 📚 文檔
• 🐛 問題反饋
• 💬 討論交流