mcpField
B
Bybit Mcp Full

Bybit Mcp Full

ローカル
github.com/BCusack金融データ653 週間前に更新

Bybit Mcp Full について

Bybit Mcp Fullは、AIアシスタントからBybitのv5 APIを利用するMCPサーバーです。市場データや口座、ポジションを扱い、取引は明示的な有効化後に実行できます。取引は既定で無効で、テストネットにも対応します。

主な機能

  1. 01ティッカー、板、直近の取引を取得
  2. 02ローソク足と市場統計を取得
  3. 03有効化後に注文とポジションを管理
  4. 04ウォレット残高と口座情報を照会
  5. 05テストネットと明示的な取引制御

活用シーン

  1. 01取引銘柄のリアルタイム市場データを確認
  2. 02ウォレット残高と保有ポジションを確認
  3. 03テストネットで取引操作を検証
  4. 04取引有効化後にBybitの注文を実行・管理

MCP 対応

互換クライアントに、Bybit v5の市場データ、口座、注文、ポジションのツールを提供します。取引およびポジション管理ツールはBYBIT_TRADING_ENABLED=trueの場合のみ表示されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"bybit-py": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"DOCKER_CONTAINER",
"-e",
"BYBIT_API_KEY",
"-e",
"BYBIT_API_SECRET",
"-e",
"BYBIT_TRADING_ENABLED",
"-e",
"BYBIT_TESTNET",
"falconiun/bybit-mcp"
],
"env": {
"DOCKER_CONTAINER": "<DOCKER_CONTAINER>",
"BYBIT_API_KEY": "<BYBIT_API_KEY>",
"BYBIT_API_SECRET": "<BYBIT_API_SECRET>",
"BYBIT_TRADING_ENABLED": "<BYBIT_TRADING_ENABLED>",
"BYBIT_TESTNET": "<BYBIT_TESTNET>"
}
}
}
}
起動コマンドdocker run -i --rm -e DOCKER_CONTAINER -e BYBIT_API_KEY -e BYBIT_API_SECRET -e BYBIT_TRADING_ENABLED -e BYBIT_TESTNET falconiun/bybit-mcp
設定が必要な環境変数
DOCKER_CONTAINER
BYBIT_API_KEYシークレット
BYBIT_API_SECRETシークレット
BYBIT_TRADING_ENABLED
BYBIT_TESTNET

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocifalconiun/bybit-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Bybit MCP Server

⚠️ 取引に関する警告 ⚠️
BYBIT_TRADING_ENABLED=true の場合、この MCP サーバーは Bybit で実際の取引操作を実行できます。
取引操作では実際の資金が使用され、金銭的損失が発生する可能性があります。
取引を有効にする前に、必ず最初にテストネット(BYBIT_TESTNET=true)でテストし、リスクを理解してください。
安全のため、取引はデフォルトで無効になっています。

Bybit の v5 API へのフルアクセスを提供する、包括的な Model Context Protocol(MCP)サーバーです。このサーバーを使用すると、AI アシスタントは Bybit 暗号資産取引所からリアルタイムの市場データを取得し、取引操作を実行し、ポジションを管理し、アカウント情報にアクセスできます。

🚀 本番環境対応

✅ 十分にテスト済み - すべてのエンドポイントがテストされ、動作しています
✅ Docker 対応 - 公開済みのイメージを falconiun/bybit-mcp で利用できます
✅ VS Code 連携 - すぐに使える設定を提供しています
✅ 包括的な API カバレッジ - 市場データ、取引、ポジション、アカウント管理

機能

市場データの基本機能
  • サーバー時刻:Bybit サーバーの現在時刻を取得します
  • ティッカー:取引シンボルのティッカー情報を取得します
  • オーダーブック:任意のシンボルのオーダーブックの深さを取得します
  • 最近の取引:最近の取引履歴にアクセスします
Kline/ローソク足データ
  • 標準 Kline:OHLCV ローソク足データを取得します
  • マーク価格 Kline:マーク価格の過去データを取得します
  • インデックス価格 Kline:インデックス価格の過去データを取得します
  • プレミアムインデックス Kline:プレミアムインデックス価格データを取得します
取引情報
  • 銘柄情報:取引銘柄の詳細情報を取得します
  • 資金調達率の履歴:過去の資金調達率にアクセスします
  • 未決済建玉:未決済建玉の統計情報を取得します
  • リスク制限:リスク制限情報を取得します
市場統計
  • 保険基金:保険基金のデータを取得します
  • ロング/ショート比率:ロング/ショート比率の統計情報にアクセスします
取引操作(BYBIT_TRADING_ENABLED=true が必要)
  • 注文管理:注文の発注、変更、キャンセルを自在に行えます
  • 高度な注文タイプ:成行、指値、条件付き/トリガー注文に対応しています
  • 一括操作:効率化のため、1 回のリクエストで複数の注文を実行できます
  • 注文履歴:未約定/完了注文と取引履歴を包括的に確認できます
  • リアルタイム執行:注文状況と約定について即時のフィードバックを取得できます
  • トリガー注文:価格トリガーと高度な利確/損切りロジックを備えた条件付き注文です
ポジション管理(BYBIT_TRADING_ENABLED=true が必要)
  • ポジション情報:詳細な指標を含むリアルタイムのポジションデータを照会します
  • レバレッジ制御:ポジションのレバレッジを動的に設定、変更します
  • 証拠金管理:クロスマージン/分離マージンモードを切り替えます
  • 取引停止注文:利確、損切り、トレーリングストップを設定します
  • 証拠金の自動追加:証拠金の自動追加を設定します
  • ポジションモード:片方向モードとヘッジモードを切り替えます
  • 損益の追跡:決済済み損益の記録にアクセスします
アカウントとウォレットの管理
  • ウォレット残高:ウォレット残高の包括的な情報を取得します
  • 単一コインの残高:特定のコインの残高を照会します
  • アカウント情報:アカウントの詳細情報と設定にアクセスします
  • 複数のアカウントタイプ:UNIFIED、CONTRACT、SPOT、INVESTMENT アカウントに対応しています

🎯 主な機能

✅ API を完全にカバー
  • 市場データ:Bybit v5 のすべての市場エンドポイント(ティッカー、オーダーブック、Kline、資金調達率など)
  • 取引:注文の全ライフサイクルを管理します(発注、変更、キャンセル、一括操作)
  • 高度な注文:高度なエントリー/エグジット戦略に対応した条件付き/トリガー注文
  • ポジション:ポジション管理全般に対応します(レバレッジ、証拠金、ストップ、損益の追跡)
  • アカウント:ウォレット残高、アカウント情報、複数アカウントのサポート
✅ エージェントに最適化された設計
  • 明確なツールの説明:各ツールには、目的と使い方を説明する詳細でエージェントに適した説明が付いています
  • 充実したパラメータスキーマ:例、列挙型、検証制約を含む包括的な JSON スキーマを用意しています
  • 安全性に関する警告:重要な取引ツールには、目立つ安全性の警告とリスクに関する注意を含めています
  • 使用方法のガイダンス:ツールを効果的に使用するタイミングと方法に関する背景情報を含めています
  • エラーの防止:スキーマ検証により、API 呼び出し前に一般的なパラメータの誤りを防ぎます
✅ 本番環境向けの機能
  • 安全性を最優先:取引はデフォルトで無効で、明示的な有効化が必要です
  • テストネットのサポート:安全な開発とテストのため、テストネットと完全に統合しています
  • エラー処理:詳細なエラーメッセージを含む包括的なエラー処理を備えています
  • データ検証:Pydantic モデルにより、データの整合性と型安全性を確保します
  • Docker 対応:環境変数を適切に処理する、公開済みの Docker イメージを用意しています
✅ 開発者エクスペリエンス
  • VS Code との統合:ローカル環境と Docker デプロイの両方に対応した、すぐに使える設定を用意しています
  • MCP プロトコル:AI アシスタントとの統合に向け、Model Context Protocol に完全準拠しています
  • 型安全性:Pydantic モデルによる、TypeScript スタイルの完全な型付けに対応しています
  • テスト:実際の API と連携する包括的なテストスイートを備えています
  • ドキュメント:例やベストプラクティスを含む、充実したドキュメントを用意しています

対応カテゴリ

  • 線形:USDT 無期限契約、USDC 無期限契約、USDC 先物
  • インバース:インバース無期限契約、インバース先物
  • オプション:オプション取引
  • 現物:現物取引ペア

インストール

前提条件
  • Python 3.13+
  • uv パッケージマネージャー
uvx を使用する場合(最も簡単・インストール不要)

クローンやインストールをせずに、PyPi から直接実行できます:

uvx bybit-mcp
uv を使用する場合(ローカル開発に推奨)
  1. リポジトリをクローンします:
git clone <repository-url>
cd bybit-mcp
  1. 依存関係をインストールします:
uv sync
  1. 環境変数を設定します:
# Copy the example environment file
cp .env.example .env

# Edit .env with your Bybit API credentials
BYBIT_API_KEY=your_api_key_here
BYBIT_API_SECRET=your_api_secret_here
BYBIT_TESTNET=false  # Set to true for testnet
BYBIT_TRADING_ENABLED=false  # Set to true to enable trading operations
  1. サーバーを実行します:
uv run bybit-mcp

Docker の使用

ビルドと実行
# Build the Docker image
docker build -t bybit-mcp .

# Run with environment variables (correct syntax)
docker run -i --rm --init \
  -e BYBIT_API_KEY=your_api_key \
  -e BYBIT_API_SECRET=your_api_secret \
  -e BYBIT_TESTNET=false \
  -e BYBIT_TRADING_ENABLED=false \
  bybit-mcp
Docker Compose を使用する場合
# Set environment variables in .env file first
docker-compose up
公開済みイメージを使用する場合
# Use the published Docker image
docker run -i --rm --init \
  -e BYBIT_API_KEY=your_api_key \
  -e BYBIT_API_SECRET=your_api_secret \
  -e BYBIT_TESTNET=false \
  -e BYBIT_TRADING_ENABLED=false \
  falconiun/bybit-mcp

設定

環境変数
  • BYBIT_API_KEY:Bybit API キー
  • BYBIT_API_SECRET:Bybit API シークレット
  • BYBIT_TESTNET:Bybit テストネットを使用するには true に設定します(デフォルトは false)
  • BYBIT_TRADING_ENABLED:取引操作を有効にするには true に設定します(デフォルトは false)
安全性の制御

サーバーは、取引操作に対して次の安全性の制御を実装しています。

取引はデフォルトで無効
  • すべての取引およびポジション管理ツールは、デフォルトで無効です
  • 取引を有効にするには、BYBIT_TRADING_ENABLED=true を明示的に設定する必要があります
  • この設定に関係なく、マーケットデータツールは常に利用できます
テストネットのサポート
  • Bybit のテストネット環境を使用するには、BYBIT_TESTNET=true に設定します
  • 開発とテストに推奨します
  • テストネット取引では模擬資金を使用するため、実際の残高には影響しません
ツールの表示
  • 取引ツールは、BYBIT_TRADING_ENABLED=true の場合にのみツール一覧に表示されます
  • ポジション管理ツールにも同じフラグが必要です
  • これにより、意図しない取引操作を防ぎます
API 権限

Bybit API キーに適切な権限があることを確認してください。

  • 読み取り専用:マーケットデータ用(常に安全)
  • 取引:注文操作に必要です(必要な場合にのみ有効にしてください)
  • ポジション:ポジション管理に必要です
  • 出金:このサーバーでは不要です
MCP クライアントとの統合
Claude Desktop

Claude Desktop で Bybit MCP サーバーを使用するには、次の設定を Claude Desktop の MCP 設定ファイルに追加します。

Claude Desktop の MCP 設定ファイルの場所:

  • Windows:%APPDATA%\Claude\claude_desktop_config.json
  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux:~/.config/Claude/claude_desktop_config.json

オプション 1:公開済み Docker イメージを使用(推奨)

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "BYBIT_API_KEY=your_api_key_here",
        "-e", "BYBIT_API_SECRET=your_api_secret_here",
        "-e", "BYBIT_TESTNET=false",
        "-e", "BYBIT_TRADING_ENABLED=false",
        "falconiun/bybit-mcp"
      ]
    }
  }
}

オプション 2:uvx を使用(インストール不要)

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uvx",
      "args": [
        "bybit-mcp"
      ],
      "env": {
        "BYBIT_API_KEY": "your_api_key_here",
        "BYBIT_API_SECRET": "your_api_secret_here",
        "BYBIT_TESTNET": "false",
        "BYBIT_TRADING_ENABLED": "false"
      }
    }
  }
}

オプション 3:ローカル開発

{
  "mcpServers": {
    "bybit-mcp": {
      "command": "uv",
      "args": ["run", "bybit-mcp"],
      "cwd": "path/to/your/bybit-mcp",
      "env": {
        "BYBIT_API_KEY": "your_api_key_here",
        "BYBIT_API_SECRET": "your_api_secret_here",
        "BYBIT_TESTNET": "false",
        "BYBIT_TRADING_ENABLED": "false"
      }
    }
  }
}

Claude Desktop に関する重要な注意事項:

  • your_api_key_here と your_api_secret_here を実際の Bybit API 認証情報に置き換えてください
  • 偽の資金でテストする場合は BYBIT_TESTNET=true を設定してください(初回の使用時に推奨)
  • 実際の取引操作を有効にする場合のみ、BYBIT_TRADING_ENABLED=true を設定してください
  • 設定ファイルを変更した後は、Claude Desktop を再起動してください

Claude Desktop の使用例:

設定が完了すると、Claude Desktop に次のような質問をできます。

  • 「USDT の残高はいくらですか?」
  • 「BTCUSDT の現在の価格はいくらですか?」
  • 「ETHUSDT のオーダーブックを表示してください」
  • 「アカウントの最近の取引履歴を取得してください」
  • 「現在、どのポジションを保有していますか?」

取引を行う場合(BYBIT_TRADING_ENABLED=true の場合):

  • 「BTC を 0.001、95,000 ドルで指値買い注文してください」
  • 「未約定の注文をすべてキャンセルしてください」
  • 「BTCUSDT のレバレッジを 10x に設定してください」
  • 「BTC のポジションの損切り価格を 90,000 ドルに設定してください」

セキュリティのベストプラクティス:

  • 安全に機能をテストするため、BYBIT_TESTNET=true から始めてください
  • 必要最小限の権限を持つ API キーを使用してください(市場データには読み取り専用、必要な場合にのみ取引権限を付与)
  • API キーを含む設定ファイルを共有しないでください
  • 本番環境では、機密性の高い認証情報に環境変数を使用することを検討してください
その他の MCP クライアント

このサーバーは、MCP 互換のあらゆるクライアントで動作します。設定形式はクライアントによって多少異なる場合がありますが、基本的な設定方法は同じです。

VS Code MCP 統合
オプション 1:ローカル開発(推奨)

次の内容を VS Code の settings.json に追加します。

{
  "mcp": {
    "servers": {
      "bybit-mcp": {
        "type": "stdio",
        "command": "uvx",
        "args": ["bybit-mcp"],
        "env": {
          "BYBIT_API_KEY": "${input:bybit_api_key}",
          "BYBIT_API_SECRET": "${input:bybit_api_secret}",
          "BYBIT_TESTNET": "${input:bybit_testnet}",
          "BYBIT_TRADING_ENABLED": "${input:bybit_trading_enabled}"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "bybit_api_key",
        "description": "Bybit API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_api_secret",
        "description": "Bybit API Secret",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_testnet",
        "description": "Use Bybit Testnet",
        "default": "false"
      },
      {
        "type": "promptString",
        "id": "bybit_trading_enabled",
        "description": "Enable Bybit Trading",
        "default": "false"
      }
    ]
  }
}
オプション 2:Docker(本番環境)

公開済み Docker イメージを使用する場合:

{
  "mcp": {
    "servers": {
      "bybit-mcp": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--init",
          "-e",
          "DOCKER_CONTAINER",
          "-e",
          "BYBIT_API_KEY",
          "-e",
          "BYBIT_API_SECRET",
          "-e",
          "BYBIT_TRADING_ENABLED",
          "-e",
          "BYBIT_TESTNET",
          "falconiun/bybit-mcp"
        ],
        "env": {
          "DOCKER_CONTAINER": "true",
          "BYBIT_API_KEY": "${input:bybit_api_key}",
          "BYBIT_API_SECRET": "${input:bybit_api_secret}",
          "BYBIT_TRADING_ENABLED": "${input:bybit_trading_enabled}",
          "BYBIT_TESTNET": "${input:bybit_testnet}"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "bybit_api_key",
        "description": "Bybit API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_api_secret",
        "description": "Bybit API Secret",
        "password": true
      },
      {
        "type": "promptString",
        "id": "bybit_testnet",
        "description": "Use Bybit Testnet",
        "default": "false"
      },
      {
        "type": "promptString",
        "id": "bybit_trading_enabled",
        "description": "Enable Bybit Trading",
        "default": "false"
      }
    ]
  }
}

Docker に関する重要な注意事項:

  • Docker コンテナに環境変数を渡すには、-e フラグが必要です
  • env セクションで VS Code の環境に変数を設定し、それらの変数が Docker に渡されます
  • --init フラグは、コンテナ内でシグナルを適切に処理するために役立ちます

テスト

MCP Inspector

MCP Inspector を使用してサーバーをテストします。

npx @modelcontextprotocol/inspector uv run bybit-mcp
単体テスト
uv run pytest tests/

API リファレンス

市場データツール

すべての市場データツールは常に利用可能で、特別な権限は必要ありません。

コアデータ
  • get_server_time:Bybit サーバーの現在時刻を取得します
  • get_tickers:銘柄のティッカー情報を取得します
  • get_order_book:オーダーブックの板情報を取得します
  • get_recent_trades:最近の取引履歴を取得します
Kline/ローソク足データ
  • get_kline:標準的な OHLCV Kline データを取得します
  • get_mark_price_kline:マーク価格の過去データを取得します
  • get_index_price_kline:インデックス価格の過去データを取得します
  • get_premium_index_price_kline:プレミアムインデックス Kline データを取得します
市場情報
  • get_instruments_info:取引商品情報を取得します
  • get_funding_rate_history:資金調達率の履歴を取得します
  • get_open_interest:未決済建玉の統計情報を取得します
  • get_insurance:保険基金データを取得します
  • get_risk_limit:リスク限度額情報を取得します
  • get_long_short_ratio:ロング/ショート比率データを取得します
取引ツール(BYBIT_TRADING_ENABLED=true が必要)

これらのツールは、BYBIT_TRADING_ENABLED 環境変数で取引が有効になっている場合のみ利用できます。

注文管理
  • place_order:成行注文または指値注文を発注し、即時または指定価格で執行します
  • place_trigger_order:高度な損切り、利確、成行エントリー戦略を備えた条件付き/トリガー注文を発注します
  • amend_order:既存の未約定注文(価格、数量、トリガー条件)を変更します
  • cancel_order:特定の未約定注文をキャンセルします
  • cancel_all_orders:リスク管理を強化するため、すべての未約定注文をキャンセルします
一括操作
  • batch_place_order:1回のリクエストで複数の注文を発注します
  • batch_amend_order:1回のリクエストで複数の注文を変更します
  • batch_cancel_order:1回のリクエストで複数の注文をキャンセルします
注文情報
  • get_open_closed_orders:未約定注文と約定済み注文を取得します
  • get_order_history:注文履歴を取得します
  • get_trade_history:取引の執行履歴を取得します
ウォレットとアカウントの管理
  • get_wallet_balance:ウォレット残高の詳細情報を取得します
  • get_single_coin_balance:特定の暗号資産の残高を取得します
  • get_account_info:アカウント情報と設定の詳細を取得します
ポジションツール(BYBIT_TRADING_ENABLED=true が必要です)

ポジション管理ツールを使用するには、取引を有効にする必要があります。

ポジション情報
  • get_position_info:リアルタイムのポジションデータを照会します
  • get_closed_pnl:確定損益の記録を取得します
ポジション設定
  • set_leverage:ポジションのレバレッジを設定します
  • switch_cross_isolated_margin:マージンモードを切り替えます
  • switch_position_mode:ワンウェイモードとヘッジモードを切り替えます
  • set_auto_add_margin:マージンの自動追加を設定します
リスク管理
  • set_trading_stop:利確、損切り、トレーリングストップを設定します
  • modify_position_margin:ポジションのマージンを追加または減額します
ツール

各ツールでは、該当する場合、以下の共通パラメーターを使用できます。

  • category:商品タイプ(linear、inverse、option、spot)
  • symbol:取引シンボル(例:BTCUSDT)
  • limit:ページごとのデータ件数の上限
  • start/end:履歴データの期間
ツール呼び出しの例

サーバー時刻を取得

{
  "name": "get_server_time",
  "arguments": {}
}

ティッカーデータを取得

{
  "name": "get_tickers",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT"
  }
}

ローソク足データを取得

{
  "name": "get_kline",
  "arguments": {
    "symbol": "BTCUSDT",
    "interval": "1",
    "category": "linear",
    "limit": 100
  }
}

注文を発注(取引の有効化が必要です)

{
  "name": "place_order",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Limit",
    "qty": "0.001",
    "price": "50000.00",
    "orderLinkId": "my-order-123"
  }
}

トリガー注文を発注(取引の有効化が必要です)

{
  "name": "place_trigger_order",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "side": "Buy",
    "orderType": "Market",
    "qty": "0.001",
    "triggerPrice": "48000.00",
    "triggerDirection": 2,
    "triggerBy": "LastPrice",
    "orderLinkId": "trigger-buy-123"
  }
}

ポジション情報を取得(取引の有効化が必要です)

{
  "name": "get_position_info",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT"
  }
}

レバレッジを設定(取引の有効化が必要です)

{
  "name": "set_leverage",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "buyLeverage": "10",
    "sellLeverage": "10"
  }
}

取引停止条件を設定(取引の有効化が必要です)

{
  "name": "set_trading_stop",
  "arguments": {
    "category": "linear",
    "symbol": "BTCUSDT",
    "takeProfit": "55000.00",
    "stopLoss": "45000.00",
    "positionIdx": 0
  }
}

ウォレット残高を取得

{
  "name": "get_wallet_balance",
  "arguments": {
    "accountType": "UNIFIED",
    "coin": "USDT"
  }
}

単一のコインの残高を取得

{
  "name": "get_single_coin_balance",
  "arguments": {
    "accountType": "UNIFIED",
    "coin": "BTC"
  }
}

アカウント情報を取得

{
  "name": "get_account_info",
  "arguments": {}
}
リソース
  • bybit://market/info:利用可能なエンドポイントと機能に関する一般情報

トラブルシューティング

よくある問題
Docker で環境変数が機能しない
  • 問題:API キーが Docker コンテナーに渡されない
  • 解決策:上記の Docker 設定にある -e フラグ形式を使用してください
  • 注記:VS Code MCP 設定の env セクションで設定した変数は、VS Code の環境に設定され、その後 -e フラグを介して Docker に渡されます
Pydantic の検証エラー
  • 問題:データ型の不一致(例:整数と文字列)
  • 解決策:サーバーには、一般的な API の不整合に対する自動型変換が含まれています
  • 例:取引履歴の seq フィールドは、自動的に int から string に変換されます
取引操作が無効になっている
  • 問題:取引ツールが表示されない、または無効であるというエラーが返される
  • 解決策:環境変数に BYBIT_TRADING_ENABLED=true を設定してください
  • 安全性:安全のため、取引はデフォルトで無効になっています
API の権限エラー
  • 問題:401 Unauthorized または権限不足
  • 解決策:Bybit API キーに必要な権限があることを確認してください:
    • 読み取り専用:市場データ用(常に安全です)
    • 取引:注文操作に必要です
    • ポジション:ポジション管理に必要です
デバッグモード

ログレベルを設定してデバッグログを有効にします:

# Local development
PYTHONPATH=src python -c "import logging; logging.basicConfig(level=logging.DEBUG)" -m bybit_mcp.main

# Docker
docker run -e PYTHONPATH=src -e LOG_LEVEL=DEBUG ...

開発

プロジェクト構成
bybit-mcp/
├── src/bybit_mcp/
│   ├── __init__.py
│   ├── main.py              # MCP server implementation
│   ├── market.py            # Market data API functions
│   ├── trade.py             # Trading API functions
│   ├── position.py          # Position management functions
│   └── models/
│       ├── market_models.py # Market data Pydantic models
│       ├── trade_models.py  # Trading Pydantic models
│       └── position_models.py # Position Pydantic models
├── tests/
│   ├── test_market.py       # Market data unit tests
│   └── test_trade.py        # Trading unit tests
├── pyproject.toml           # Project configuration
├── Dockerfile               # Docker configuration
└── README.md
貢献
  1. リポジトリをフォークします
  2. 機能ブランチを作成します
  3. 変更を加えます
  4. 新しい機能のテストを追加します
  5. テストスイートを実行します
  6. プルリクエストを送信します
コード品質

このプロジェクトでは、以下を使用しています。

  • Ruff:リンティングとフォーマット
  • Pytest:テスト
  • Pydantic:データ検証
  • 型ヒント:コードのドキュメント性の向上
最近の更新

v0.1.0 - 本番リリース

  • ✅ Bybit v5 API を全面的にカバー(市場データ、取引、ポジション、アカウント)
  • ✅ Docker イメージを falconiun/bybit-mcp に公開
  • ✅ Pydantic の検証に関する問題を修正(seq フィールドの型変換)
  • ✅ 動作する Docker 設定を備えた、包括的な VS Code MCP 統合
  • ✅ エラーハンドリングと安全制御を強化
  • ✅ ウォレットとアカウントの完全な管理に対応
  • ✅ 安全な開発のためのテストネットに対応
  • ✅ 包括的なテストを備え、本番環境ですぐに利用可能

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

免責事項

このソフトウェアは、教育および開発を目的としています。本番環境で使用する前に、必ず十分にテストしてください。このソフトウェアの使用によって発生した金銭的損失について、作者は一切責任を負いません。

サポート

問題や質問がある場合:

  1. 既存の GitHub Issues を確認します
  2. 詳細情報を添えて新しいイシューを作成します
  3. 該当する場合は、ログとエラーメッセージを提示します

プロジェクトを支援する

この MCP サーバーが取引や開発に役立つ場合は、継続的な開発へのご支援をご検討ください。

Patreon で支援

ko-fi

ご支援は、このプロジェクトの保守と改善、新機能の追加、最新の Bybit API 更新との互換性の維持に役立ちます。ご支援をご検討いただき、ありがとうございます。

謝辞

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。