MCP Bitget Trading

🚀 MCP Bitget取引サーバー

Bitget暗号通貨取引所向けのMCP（Model Context Protocol）サーバーです。AIアシスタントがBitget APIとやり取りし、現物および先物取引を行うことを可能にします。リアルタイムの市場データ、注文管理、口座残高、レバレッジ制御、ポジション追跡などの機能が備わっています。ペーパートレードモードによるデモ取引もサポートしています。

✨ 主な機能

📊 市場データ

• リアルタイム価格 - 任意の取引ペアの現在の市場価格を取得
• 完全なティッカー - 24時間の統計情報を含む完全なティッカー情報
• 板情報 - 設定可能な深度レベルでの市場深度データ
• 過去のローソク足 - テクニカル分析用のOHLCVデータ

💰 口座管理

• 残高情報 - すべての資産のリアルタイムの口座残高
• ポジション追跡 - 現在の先物ポジションを監視
• 証拠金情報 - 先物証拠金口座の詳細
• 注文管理 - 未決済の注文を表示および管理

🎯 取引操作

• 注文発注 - 成行注文と指値注文を実行
• 注文取消 - IDで既存の注文を取消
• レバレッジ制御 - 先物ポジションのレバレッジを設定（1 - 125倍）
• デモ取引 - ペーパートレードモードを完全にサポート

⚡ 技術的な特徴

• TypeScript - 完全に型付けされた実装
• v2 APIサポート - 最新のBitget API統合
• レート制限 - API制限に対する組み込みの保護
• エラー処理 - 包括的なエラー管理
• Zod検証 - すべてのパラメータの入力検証

📦 インストール

前提条件

• Node.js 18以上
• npmまたはyarn
• Bitget API資格情報（実際の/デモ取引用）

クイックスタート

1. リポジトリをクローン

git clone https://github.com/gagarinyury/MCP-bitget-trading.git
cd MCP-bitget-trading

2. 依存関係をインストール

npm install

3. 環境を設定

cp .env.example .env
# .envを編集し、Bitget API資格情報を入力

4. プロジェクトをビルド

npm run build

5. サーバーを起動

npm start

🔧 設定

環境変数

ルートディレクトリに.envファイルを作成します。

# Bitget API設定
BITGET_API_KEY=your_api_key_here
BITGET_SECRET_KEY=your_secret_key_here
BITGET_PASSPHRASE=your_passphrase_here

# 環境設定
BITGET_SANDBOX=true  # デモ取引の場合はtrueに設定
BITGET_BASE_URL=https://api.bitget.com
BITGET_WS_URL=wss://wspap.bitget.com/v2/ws/public

# オプション設定
LOG_LEVEL=info
RATE_LIMIT_REQUESTS_PER_SECOND=10

Claude Desktop統合

Claude DesktopのMCP設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "bitget-trading": {
      "command": "node",
      "args": ["/path/to/MCP-bitget-trading/dist/server.js"],
      "env": {
        "BITGET_API_KEY": "your_key",
        "BITGET_SECRET_KEY": "your_secret",
        "BITGET_PASSPHRASE": "your_passphrase",
        "BITGET_SANDBOX": "true"
      }
    }
  }
}

📚 利用可能なツール

市場データツール

口座ツール

取引ツール

💻 使用例

基本的な価格チェック

// 現在のビットコイン価格を取得
await getPrice({ symbol: "BTCUSDT" })

// 先物価格を取得
await getPrice({ symbol: "BTCUSDT_UMCBL" })

取引操作

// 指値買い注文を発注
await placeOrder({
  symbol: "BTCUSDT",
  side: "buy",
  type: "limit",
  quantity: "0.001",
  price: "50000"
})

// 先物のレバレッジを設定
await setLeverage({
  symbol: "BTCUSDT_UMCBL",
  leverage: 10
})

口座情報

// 残高を確認
await getBalance({ asset: "USDT" })

// すべてのポジションを取得
await getPositions({})

🏗️ 開発

スクリプト

npm run dev      # ホットリロードで開発
npm run build    # 本番用ビルド
npm run test     # テストを実行
npm run lint     # コードをリント
npm run format   # コードをフォーマット

プロジェクト構造

src/
├── api/
│   └── rest-client.ts    # Bitget REST APIクライアント
├── types/
│   ├── bitget.ts         # Bitget APIの型
│   └── mcp.ts           # MCPスキーマ定義
└── server.ts            # メインのMCPサーバー

📋 シンボル形式

現物取引

• 形式: BTCUSDT, ETHUSDT, ADAUSDT
• サフィックスは不要

先物取引

• 形式: BTCUSDT_UMCBL, ETHUSDT_UMCBL
• USDT建てコントラクトの場合は_UMCBLサフィックス

🔒 セキュリティ

• APIキー: 環境変数に保存し、コードにコミットしないでください
• デモモード: ペーパートレードにはBITGET_SANDBOX=trueを使用
• レート制限: 組み込みの保護（デフォルトで10リクエスト/秒）
• 検証: すべての入力はZodスキーマで検証

🐛 トラブルシューティング

一般的な問題

1. エラー40009 - 署名エラー

   • APIキーの設定を確認
   • タイムスタンプが同期していることを確認

2. エラー40099 - 取引所環境が正しくない

   • デモ/本番モードの設定を確認
   • デモモードの場合はpaptradingヘッダーを確認

3. エラー400172 - パラメータ検証に失敗しました

   • 必須パラメータを確認
   • シンボル形式を確認

🤝 コントリビューション

1. リポジトリをフォーク
2. 機能ブランチを作成（git checkout -b feature/amazing-feature）
3. 変更をコミット（git commit -m 'Add amazing feature'）
4. ブランチにプッシュ（git push origin feature/amazing-feature）
5. プルリクエストを作成

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

⚠️ 免責事項

このソフトウェアは教育および開発目的で提供されています。自己責任で使用してください。本番取引の前に必ずデモモードでテストしてください。著者はいかなる金融的損失にも責任を負いません。

🔗 リソース

• Bitget APIドキュメント
• Model Context Protocol
• Claude Desktop

📞 サポート

• 問題報告: GitHub Issues
• ディスカッション: GitHub Discussions

暗号通貨取引コミュニティのために愛を込めて作られました。