Binance MCP Server 🚀

Binance MCP Server 🚀

AI エージェントが Binance 暗号資産取引所 とシームレスに連携できる、強力な Model Context Protocol（MCP）サーバー です。このサーバーは、標準化された MCP インターフェースを通じて、包括的な取引ツール一式、市場データへのアクセス、アカウント管理機能を提供します。

🌟 これは何ですか？

このツールは、AI アシスタント（Claude、Cursor AI、ChatGPT など）とお使いの Binance アカウント をつなぐ橋渡し役です。

Binance のウェブサイトやアプリを手動で操作する代わりに、AI に次のように依頼できます。

• 「Bitcoin の現在価格を確認して」
• 「アカウント残高を表示して」
• 「現在の市場価格で 0.1 ETH を購入して」

AI はリクエストをこのサーバーに送信し、サーバーが Binance 上で安全に実行して、結果を AI に返します。

🚀 クイックスタート

1️⃣ インストール

最も簡単なインストール方法は、pip または uv を使用することです。

# using pip
pip install binance-mcp-server
# using uv
uv add binance-mcp-server

2️⃣ 設定

このツールがアカウントにアクセスできるようにするには、Binance API キー が必要です。

1. Binance アカウントにログインし、API Management に移動します。
2. 新しい API キーを作成します。
3. ターミナルで、キーを環境変数として設定します。

# Required: Your Binance API credentials
export BINANCE_API_KEY="your_api_key_here"
export BINANCE_API_SECRET="your_api_secret_here"

# Recommended: Use testnet for development and safe testing
export BINANCE_TESTNET="true"

3️⃣ AI で実行

Claude Desktop / VSCode / Cursor 向けの設定

MCP 設定ファイル（例：claude_desktop_config.json または mcp_config.json）に、次の内容を追加します。

{
  "mcpServers": {
    "binance": {
      "command": "binance-mcp-server",
      "args": [
        "--api-key", "your_api_key",
        "--api-secret", "your_secret",
        "--binance-testnet"
      ]
    }
  }
}

🎯 主な機能

• リアルタイム市場データ：リアルタイムの価格、注文板、ティッカー統計を取得します。
• アカウント管理：残高とアカウントの状態を確認します。
• 取引操作：買い注文／売り注文（成行、指値など）を発注します。
• ポートフォリオ追跡：未決済ポジションと損益（PnL）を監視します。

📚 技術リファレンス

利用可能なツール

クリックしてツールの全一覧を展開

🏦 アカウントとポートフォリオの管理

ツール	用途
get_balance	すべての資産のアカウント残高を取得
get_account_snapshot	特定時点のアカウント状態のスナップショット
get_fee_info	取引手数料率（メイカー／テイカー手数料）
get_available_assets	取引可能な暗号資産の一覧

📊 市場データと分析

ツール	用途
get_ticker_price	取引シンボルの現在価格
get_ticker	24 時間のティッカー価格変動統計
get_order_book	現在の注文板（買い注文／売り注文）

💱 取引操作

ツール	用途
create_order	買い注文／売り注文を作成（成行、指値など）
get_orders	特定のシンボルの注文履歴を一覧表示

📈 パフォーマンスと分析

ツール	用途
get_pnl	先物取引の損益を計算
get_position_info	未決済の先物ポジションの詳細

🏪 ウォレットと送金

ツール	用途
get_deposit_address	特定のコインの入金アドレスを取得
get_deposit_history	特定のコインの入金履歴
get_withdraw_history	特定のコインの出金履歴

🛡️ リスク管理

ツール	目的
get_liquidation_history	先物の過去の清算イベント

設定変数

変数	説明	必須	デフォルト
BINANCE_API_KEY	Binance API キー	✅	-
BINANCE_API_SECRET	Binance API シークレット	✅	-
BINANCE_TESTNET	テストネット環境を使用します	❌	false

🛠️ 開発とコントリビューション

コントリビューションを歓迎します。このプロジェクトの改善に取り組みたい開発者の方は、以下をご覧ください。

1. リポジトリをクローンする：git clone https://github.com/AnalyticAce/binance-mcp-server.git
2. 開発用の依存関係をインストールする：uv install --dev または pip install -e .[dev]
3. テストを実行する：pytest

詳しいガイドラインについては、CONTRIBUTING.mdをご覧ください。

📄 ライセンスと免責事項

ライセンス：MIT

免責事項：このソフトウェアは教育目的で提供されています。暗号資産の取引には金融リスクが伴います。テストと開発には、必ず Binance Testnet を使用してください。開発者は、いかなる金銭的損失についても責任を負いません。