Binance Alpha MCP

🚀 Binance Alpha MCP

Binance Alpha取引を追跡するMCPサーバーで、AIエージェントがアルファポイントの蓄積を最適化するのを支援します。

✨ 主な機能

• リアルタイム取引監視：オンチェーンイベントを購読することで、Binance Alphaトークンの買い側の活動を追跡します。
• 米ドルベースの指標：CryptoCompareからのリアルタイム価格を使用して、取引価値を米ドルで計算します。
• データ永続化：取引データをメモリ内に保持し、1時間以上古いレコードは自動的に削除します。
• MCPツール：
  • get_top_tokens：米ドル取引額で上位のトークンのマークダウンテーブルを返します。シンボル、米ドル取引額、名前、アドレスが含まれます。
  • get_trade_stats：取引の米ドル価値の統計情報（最小値、最大値、中央値）と分布表を提供します。
• 設定可能なエンドポイント：イベントリスニング用のWebSocket (WS_ENDPOINT) とトークンクエリ用のHTTP (RPC_ENDPOINT) の別々のエンドポイントを使用します。

📦 インストールの前提条件

• Node.js：バージョン18以上。
• npm：依存関係の管理に使用します。
• BSCノードアクセス：イベントリスニング用のWebSocketエンドポイントとトークンクエリ用のHTTP RPCエンドポイントが必要です。InfuraやQuikNodeなどのサービスから取得できます。

📦 インストール

1. リポジトリのクローン：

   git clone https://github.com/kukapay/binance-alpha-mcp.git
   cd binance-alpha-mcp
   

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

   npm install
   

3. MCPクライアントの設定： Claude DesktopのようなMCPクライアントでこのサーバーを使用するには、設定ファイル（または同等のもの）に以下を追加します。

   {
     "mcpServers": {
       "binance-alpha-mcp": {
         "command": "node",
         "args": ["/absolute/path/to/binance-alpha-mcp/index.js"],
         "env": { 
            "WS_ENDPOINT": "your_ws_endpoint_url",
            "RPC_ENDPOINT": "your_rpc_endpoint_url"
         }
       }
     }
   }   
   

   /absolute/path/to/binance-alpha-mcp を実際のインストールパスに置き換え、WS_ENDPOINT と RPC_ENDPOINT を独自のエンドポイントURLに更新してください。

💻 使用例

基本的な使用法

サーバーは2つのMCPツールを公開しています。

get_top_tokens

• 説明：米ドル取引額で上位のトークンのマークダウンテーブルを返します。
• 入力：{ limit: number }（オプション、デフォルトは10）。出力に含めるトークンの数を指定します。
• 出力例：

  period: last 23 minutes
  | Symbol | USD Volume | Name | Address |
  |--------|------------|------|---------|
  | ZK | $72516.34 | Polyhedra Network | 0xc71b5f631354be6853efe9c3ab6b9590f8302e81 |
  | B2 | $22893.72 | BSquared Token | 0x783c3f003f172c6ac5ac700218a357d2d66ee2a2 |
  | AIOT | $5249.05 | OKZOO | 0x55ad16bd573b3365f43a9daeb0cc66a73821b4a5 |
  | gorilla | $3263.95 | gorilla | 0xcf640fdf9b3d9e45cbd69fda91d7e22579c14444 |
  | BOOP | $2046.32 | BOOP | 0x9a70815dfb644a24b57358e1041f8d0324c8f6e1 |
  | BANK | $1305.38 | Lorenzo Governance Token | 0x3aee7602b612de36088f3ffed8c8f10e86ebf2bf |
  | SKYAI | $1015.69 | SKYAI | 0x92aa03137385f18539301349dcfc9ebc923ffb10 |
  | KOGE | $672.59 | BNB48 Club Token | 0xe6df05ce8c8301223373cf5b969afcb1498c5528 |
  | MYX | $477.85 | MYX | 0xd82544bf0dfe8385ef8fa34d67e6e4940cc63e16 |
  | Drama | $108.37 | Drama | 0xf922fb5f88c19f363cb018e8f7c98c10ed294444 |
  

get_trade_stats

• 説明：取引の米ドル価値に関する統計情報（最小値、最大値、中央値）と分布表を返します。
• 入力：{ buckets: number }（オプション、デフォルトは10）。取引分布を米ドル価値で分割するバケットの数を指定します。
• 出力例：

  period: last 1 minutes
  min: $0.30, max: $2469.14, median: $653.41
  | range | count |
  |-------|-------|
  | 0.30~247.19 | 26 |
  | 247.19~494.07 | 22 |
  | 494.07~740.95 | 39 |
  | 740.95~987.84 | 6 |
  | 987.84~1234.72 | 16 |
  | 1234.72~1481.61 | 9 |
  | 1481.61~1728.49 | 1 |
  | 1728.49~1975.38 | 6 |
  | 1975.38~2222.26 | 10 |
  | 2222.26~2469.14 | 2 |
  

📄 ライセンス

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