Bybit MCP Server

Bybit MCP Server

Bybit の取引 API を Machine Cognition Protocol（MCP）に接続し、AI を活用した暗号資産取引を可能にする高機能サーバーです。

概要

Bybit MCP Server は、Machine Cognition Protocol（MCP）を使用して Bybit の取引プラットフォームと AI システムをつなぐブリッジです。市場分析、テクニカル指標の計算、自動取引操作のための強力なツールを提供します。

機能

• リアルタイムの市場データ：現在の価格、板情報、過去のデータにアクセスできます
• 高度なテクニカル分析：RSI、MACD、ATR などの指標を計算できます
• 複数時間足の分析：複数の時間足にわたって市場トレンドを分析できます
• 自動取引：プログラムから注文の発注、変更、キャンセルができます
• リスク管理：ボラティリティに基づくポジションサイズの推奨
• サポート／レジスタンスの検出：より適切なエントリー／決済ポイントを見つけるための重要な価格水準を特定します
• Docker のサポート：Docker と docker-compose による簡単なデプロイ

要件

• Python 3.12+
• Bybit API の認証情報
• 有効なインターネット接続

インストール

Virtualenv を使用したローカルインストール

1. リポジトリをクローンします：

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

2. 仮想環境を作成して有効化します：

   uv venv
   source .venv/bin/activate
   

3. 依存関係をインストールします：

   uv pip install -e .
   

4. API 認証情報を記載した .env ファイルを作成します：

   BYBIT_API_KEY=your_api_key
   BYBIT_API_SECRET=your_api_secret
   BYBIT_TESTNET=True  # Set to False for production
   

Docker を使用

1. リポジトリをクローンします：

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

2. API 認証情報を記載した .env ファイルを作成します（上記と同様）

3. Docker Compose でビルドして実行します：

   docker-compose build
   docker-compose up -d
   

使用方法

サーバーの起動

サーバーをローカルで実行するには：

mcp run main.py -t sse

サーバーはデフォルトでポート 8000 で起動します。Docker を使用する場合、サービスはポート 80 で公開されます。

利用可能なツール

サーバーは以下のツールを提供します：

ツール名	説明
get_balance	現在のウォレット残高を取得します
get_ticker	指定した銘柄の現在価格、出来高、その他のデータを取得します
get_klines	分析用の過去のローソク足データを取得します
analyze_market	指定した銘柄の包括的なテクニカル分析を実行します
analyze_multi_timeframe	複数の時間足にわたって分析を実行します
place_order	利確／損切りを指定して買い／売り注文を発注します
cancel_order	有効な注文をキャンセルします
get_active_orders	有効な注文をすべて一覧表示します
get_active_positions	保有中のポジションをすべて一覧表示します

MCP を使用した例

MCP 対応クライアントに接続した場合：

# Example of using the MCP client to get a market analysis
analysis = mcp_client.call("analyze_market", symbol="BTCUSDT", intervalo="60")
print(analysis)

# Example of placing a market order
order = mcp_client.call("place_order",
                       symbol="BTCUSDT",
                       side="Buy",
                       order_type="Market",
                       qty=0.001,
                       stop_loss=25000)
print(order)

プロジェクト構成

bybit-mcp-server/
├── main.py            # Main server file with MCP tools
├── pyproject.toml     # Project dependencies and metadata
├── Dockerfile         # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── .env               # Environment variables (create this yourself)
└── README.md          # This file

環境変数

変数	説明	デフォルト値
BYBIT_API_KEY	Bybit の API キー	なし（必須）
BYBIT_API_SECRET	Bybit の API シークレット	なし（必須）
BYBIT_TESTNET	テストネット（True）とメインネット（False）のどちらを使用するか	True

コントリビューション

コントリビューションを歓迎します！Bybit MCP Server の改善にご協力いただける場合は、以下の手順に従ってください：

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 の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

免責事項

このソフトウェアは教育目的のみで提供されています。ご自身の責任でご利用ください。暗号資産の取引には重大なリスクが伴い、損失が発生する可能性があります。過去の実績は将来の結果を示すものではありません。