Bybit MCP Server

🚀 Bybit MCP Server

Bybit取引所向けのModel Context Protocol (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と同じ設定を使用しますが、mcp.serversを使って.cursor/mcp_config.jsonに追加します。

🌐 環境設定

オプション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 - 過去のローソク足データを取得します。
• 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の現在の価格を取得して"
• "レベル50でETHUSDTのオーダーブックを表示して"
• "私のアカウント残高を取得して"
• "45000ドルで0.1BTCの指値買い注文を出して"
• "BTCUSDTのすべての未決済注文をキャンセルして"
• "過去20件の取引履歴を取得して"

🔒 セキュリティ

⚠️ 重要なセキュリティ注意事項

• テストネット は安全のためのデフォルトで推奨される環境です。
• メインネット の操作は実際の資金を使用するため、極めて注意して使用してください。
• APIキーはエラーメッセージから自動的に隠されます。
• メインネットを使用する前に常にテストネットで十分にテストしてください。
• メインネットを使用するとき、取引操作には警告が表示されます。

🔐 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
# .envをあなたのAPI資格情報で編集します。

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ファイルを参照してください。

🛠️ サポート

• 📚 ドキュメント
• 🐛 問題報告
• 💬 ディスカッション