Binance Us MCP

🚀 Binance.US MCPサーバー

Binance.US仮想通貨取引所APIとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このMCPサーバーを使用することで、Binance.US取引所の機能にプログラムでアクセスできます。以下に、主な機能を紹介します。

✨ 主な機能

• 市場データ：リアルタイムの価格、オーダーブック、取引履歴
• 現物取引：注文の発注、キャンセル、管理
• ウォレット管理：入金、出金、残高確認
• アカウント情報：アカウント詳細、取引履歴
• ステーキング：サポートされている資産で報酬を獲得
• 店頭取引（OTC）：店頭取引の実行
• サブアカウント：サブアカウントの管理
• 保管ソリューション：保管パートナー向け（特別なAPIキーが必要）
• クレジットライン：機関投資家向け（特別なAPIキーが必要）

Binance.USとBinance.comの比較

このサーバーは、Binance.US専用に設計されており、Binance.comといくつかの重要な点で異なります。

APIキーの種類

Binance.USは3種類のAPIキーを提供しています。

1. 取引APIキー

• ほとんどのユーザー向けの標準APIキー
• 市場データ、取引、ウォレット、アカウントエンドポイントへのアクセス
• 作成場所：Binance.US > プロフィール > API管理

2. 保管ソリューションAPIキー

• 保管取引ネットワーク契約を締結したユーザー向け
• 保管専用のエンドポイントのみにアクセス可能
• 参加する保管パートナーとの契約が必要

3. クレジットラインAPIキー

• クレジットライン契約を締結した機関投資家向け
• クレジットライン専用のエンドポイントのみにアクセス可能
• Binance.USとの署名済みクレジットライン契約が必要

📦 インストール

# リポジトリをクローンする
git clone https://github.com/nirholas/universal-crypto-mcp.git
cd universal-crypto-mcp/binance-us-mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

設定

環境変数

.envファイルを作成するか、以下の環境変数を設定してください。

BINANCE_US_API_KEY=your_api_key_here
BINANCE_US_API_SECRET=your_api_secret_here

Claude Desktopの設定

Claude Desktopの設定ファイル（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加してください。

{
  "mcpServers": {
    "binance-us-mcp": {
      "command": "node",
      "args": ["/path/to/binance-us-mcp-server/build/index.js"],
      "env": {
        "BINANCE_US_API_KEY": "your_api_key",
        "BINANCE_US_API_SECRET": "your_api_secret"
      }
    }
  }
}

💻 使用例

開発環境

# ホットリロードで開発モードで実行する
npm run dev

# MCPインスペクターでテストする
npm test

本番環境

# プロジェクトをビルドする
npm run build

# サーバーを起動する
npm start

利用可能なツールのカテゴリ

市場データ（公開）

• ティッカー価格の取得
• オーダーブックの深さの取得
• 最近の取引の取得
• K線/ローソク足データの取得
• 24時間統計の取得
• 取引所情報の取得

現物取引（APIキーが必要）

• 新しい注文の発注（指値、成行、逆指値）
• 注文のキャンセル
• 未決済注文の取得
• 注文ステータスの取得
• 取引履歴の取得

ウォレット（APIキーが必要）

• 残高の取得
• 入金アドレスの取得
• 入金履歴の取得
• 出金履歴の取得
• 資金の出金

アカウント（APIキーが必要）

• アカウント情報の取得
• 取引履歴の取得
• APIキーの権限の取得

ステーキング

• ステーキング商品の取得
• ステーキングの申し込み
• ステーキングの償還
• ステーキング履歴の取得

店頭取引（OTC）

• OTC見積もりの取得
• OTC取引の実行

サブアカウント

• サブアカウントの作成
• サブアカウントリストの取得
• アカウント間の送金

保管ソリューション（特別なAPIキー）

• 保管専用の操作
• パートナー統合

クレジットライン（特別なAPIキー）

• クレジットラインの管理
• 機関投資家向けの機能

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

1. APIキーを決して共有しない - パスワードと同じように扱う
2. IP制限を使用する - API設定で信頼できるIPのみをホワイトリストに登録する
3. 権限を制限する - 必要な権限のみを有効にする
4. 別々のキーを使用する - 異なるアプリケーションに異なるキーを作成する
5. 定期的にキーを更新する - 定期的に新しいキーを生成する
6. アクティビティを監視する - 不正アクセスをチェックする

レート制限

Binance.USには以下のレート制限があります。

• リクエストウェイト：1分あたり1200
• 注文：1秒あたり10、1日あたり100,000
• 生のリクエスト：5分あたり5000

サーバーは自動的にレート制限を処理しますが、多数のリクエストを行う場合はこれらの制限に注意してください。

エラーハンドリング

サーバーは標準化されたエラーレスポンスを返します。

{
  "success": false,
  "error": {
    "code": -1121,
    "msg": "Invalid symbol."
  }
}

一般的なエラーコード：

• -1000：不明なエラー
• -1002：認証されていません
• -1021：タイムスタンプがrecvWindow外です
• -1022：無効な署名です
• -2010：新しい注文が拒否されました
• -2011：キャンセルが拒否されました

コントリビュート

コントリビューションは大歓迎です！プルリクエストを送信する前に、コントリビューションガイドラインを読んでください。

📚 ドキュメント

詳細なドキュメントはdocs/フォルダにあります。

• - パラメータ、例、およびレスポンスを含む完全なツールリファレンス
• - APIクライアントのアーキテクチャ、型、およびエラーハンドリング
• - すべてのツールの高速参照ガイド
• - 取引ツールと注文管理（すべての13のツール）
• - 取引ツールのチートシート
• - 解決策を含む完全なエラーコードリファレンス

📄 ライセンス

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

リソース

• Binance.US APIドキュメント
• モデルコンテキストプロトコル
• MCP SDKドキュメント

🌐 ライブHTTPデプロイメント

Binance US MCPは、MCP Streamable HTTPトランスポートを介してHTTPでデプロイされ、アクセス可能です。ローカルインストールは必要ありません。

エンドポイント:

https://modelcontextprotocol.name/mcp/binance-us-mcp

任意のMCPクライアントから接続する

MCPクライアントの設定（Claude Desktop、Cursor、SperaxOSなど）に以下を追加してください。

{
  "mcpServers": {
    "binance-us-mcp": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/binance-us-mcp"
    }
  }
}

利用可能なツール（3つ）

リクエストの例

Binance.USの価格を取得する:

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_ticker_price","arguments":{"symbol":"BTCUSD"}}}'

24時間の統計を取得する:

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_24h_stats","arguments":{"symbol":"ETHUSD"}}}'

オーダーブックを取得する:

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_order_book","arguments":{"symbol":"BTCUSD","limit":5}}}'

すべてのツールをリストする

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

また、以下でも利用可能

• SperaxOS — MCPマーケットプレイスから閲覧およびインストールできます
• すべての27のMCPサーバー — modelcontextprotocol.nameで完全なカタログを確認できます

modelcontextprotocol.name（オープンMCP HTTPゲートウェイ）によって提供されています

スター履歴