EDUCHAIN Agent Kit

この MCP（Model Context Protocol）サーバーは、EDUCHAIN とやり取りするためのツールとリソースを提供します。Claude がトークンやプールの情報を照会し、SailFish DEX を通じてスワップできるようにします。

機能

トークンとプールの情報

• トークンの価格と詳細を取得
• プールの情報と統計を取得
• トークンとプールの過去のデータを表示
• TVL 順に上位のトークンとプールを取得

ウォレット操作

• EDU とトークンの残高を確認
• トークンと NFT を含むウォレットの概要を取得
• EDU と ERC20 トークンを送信

スワップ操作

• 価格への影響とルート情報を含むスワップ見積もりを取得
• トークンを別のトークンにスワップ
• EDU をトークンにスワップ（内部では WEDU を使用）
• トークンを EDU にスワップ（内部では WEDU を使用）

注記： 他の Uniswap v3 フォークと同様に、SailFish DEX はネイティブトークンの直接スワップに対応していません。代わりに、内部で WEDU（Wrapped EDU）を使用します。EDU のスワップ関数を使用すると、ラップとアンラップの処理が自動的に行われるため、トランザクションでは EDU を直接扱えます。より細かく制御する必要がある場合は、wrap_edu と unwrap_wedu 関数を使用して、EDU と WEDU を手動で変換することもできます。

アービトラージ操作

• 中央集権型取引所から EDU の外部市場データを取得
• CEX と SailFish DEX 間のアービトラージ機会を確認
• 外部市場データ API を設定可能
• アービトラージ検出しきい値をカスタマイズ可能

ツール

トークンとプールの情報

• get_token_price：SailFish DEX 上のトークンの現在価格を取得
• get_token_info：SailFish DEX 上のトークンの詳細情報を取得
• get_pool_info：SailFish DEX 上の流動性プールの詳細情報を取得
• get_top_tokens：SailFish DEX 上で TVL 順に上位のトークン一覧を取得
• get_top_pools：SailFish DEX 上で TVL 順に上位の流動性プール一覧を取得
• get_total_tvl：SailFish DEX のロックされた総額（TVL）を取得
• get_24h_volume：SailFish DEX の24時間取引量を取得
• get_token_historical_data：SailFish DEX 上のトークンの過去のデータを取得
• get_pool_historical_data：SailFish DEX 上の流動性プールの過去のデータを取得

ウォレット操作

• get_edu_balance：ウォレットアドレスの EDU 残高を取得
• get_token_balance：ウォレットアドレスのトークン残高と米ドル換算額を取得
• get_multiple_token_balances：ウォレットアドレスの複数のトークン残高を取得
• get_nft_balance：特定の NFT コレクションについて、ウォレットアドレスの NFT 残高を取得
• get_wallet_overview：EDU、トークン、NFT を含むウォレットの概要を取得
• get_wallet_address_from_private_key：秘密鍵からウォレットアドレスを取得
• send_edu：EDU ネイティブトークンを別のウォレットアドレスに送信
• send_erc20_token：ERC20 トークンを別のウォレットアドレスに送信

スワップ操作

• get_swap_quote：SailFish DEX でトークンをスワップする見積もりを取得
• swap_tokens：SailFish DEX でトークンをスワップ（トークンからトークン）
• swap_edu_for_tokens：SailFish DEX で EDU をトークンにスワップ
• swap_tokens_for_edu：SailFish DEX でトークンを EDU にスワップ
• wrap_edu：EDU を WEDU（Wrapped EDU）にラップ
• unwrap_wedu：WEDU（Wrapped EDU）を EDU にアンラップ

アービトラージ操作

• get_external_market_data：中央集権型取引所から EDU の外部市場データを取得します
• check_arbitrage_opportunities：CEX と SailFish DEX 間のアービトラージ機会を確認します
• update_external_market_config：外部市場データ API の設定を更新します
• get_external_market_config：外部市場データ API の現在の設定を取得します

設定

• set_rpc_url：ブロックチェーンとのやり取りに使用する RPC URL を設定します
• get_rpc_url：ブロックチェーンとのやり取りに現在使用している RPC URL を取得します

リソース

• sailfish://overview：TVL、取引量、その他の指標を含む SailFish DEX の概要
• sailfish://token/{tokenId}：SailFish DEX 上の特定のトークンに関する情報
• sailfish://pool/{poolId}：SailFish DEX 上の特定の流動性プールに関する情報

インストール

1. Node.js がインストールされていることを確認します
2. このリポジトリをクローンします
3. 依存関係をインストールします：

   npm install
   

4. プロジェクトをビルドします：

   npm run build
   

5. MCP サーバーを Claude Desktop の設定ファイルに追加します：

   {
     "mcpServers": {
       "sailfish": {
         "command": "node",
         "args": ["/path/to/SubgraphMCP/build/index.js"],
         "env": {
           "RPC_URL": "https://your-edu-rpc-url.com"
         }
       }
     }
   }
   

使用例

トークン価格を取得する

use_mcp_tool("sailfish", "get_token_price", {
  "tokenId": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342"
});

スワップ見積もりを取得する

use_mcp_tool("sailfish", "get_swap_quote", {
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10"
});

トークンをスワップする

use_mcp_tool("sailfish", "swap_tokens", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10",
  "slippagePercentage": 0.5
});

アービトラージ機会を確認する

use_mcp_tool("sailfish", "check_arbitrage_opportunities", {
  "threshold": 1.5
});

外部市場 API の設定を更新する

use_mcp_tool("sailfish", "update_external_market_config", {
  "apiUrl": "https://api.example.com/crypto/prices",
  "apiKey": "YOUR_API_KEY",
  "symbols": {
    "EDU": "EDU",
    "USD": "USDT"
  }
});

EDU を WEDU にラップする

use_mcp_tool("sailfish", "wrap_edu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

WEDU を EDU にアンラップする

use_mcp_tool("sailfish", "unwrap_wedu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

テスト

テストスクリプトを実行して、機能を検証できます：

node build/test.js

これにより、実際のスワップを実行せずに、ルーティングとスワップ見積もりの機能をテストできます。

ライセンス

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