mcpField
S
Sui Analytics

Sui Analytics

ローカル
github.com金融データ31 日前に更新
リポジトリ公式サイト

Sui Analytics について

Sui Analyticsは、Sui上の活動を調査する読み取り専用MCPサーバーです。資金の流れ、プロトコル取引、ウォレット間の関係を調べる分析担当者向けで、アカウント、APIキー、ウォレットは不要です。

主な機能

  1. 01資金の移動と出所を追跡
  2. 02プロトコル取引をデコード
  3. 03マルチシグ承認を分析
  4. 04残高、DeFiポジション、NFTを参照
  5. 05価格とMoveパッケージを照会

活用シーン

  1. 01Sui上の資金の移動先を調査
  2. 02不審な取引やプロトコル活動を分析
  3. 03ウォレットの資金源と関連を確認
  4. 04トークンやプロトコルの制御権限を調査

MCP 対応

MCPクライアントにSui調査ツールを提供します。公開エンドポイントを読み取り専用で参照し、トランザクションは送信しません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "0xfreak0-sui": {
      "command": "npx",
      "args": [
        "-y",
        "sui-analytics-mcp"
      ],
      "env": {
        "SUI_NETWORK": "<SUI_NETWORK>",
        "SUI_FULLNODE_URL": "<SUI_FULLNODE_URL>",
        "SUI_GRAPHQL_URL": "<SUI_GRAPHQL_URL>",
        "SUI_RATE_LIMIT": "<SUI_RATE_LIMIT>",
        "SUI_TOOLS": "<SUI_TOOLS>",
        "SUI_DECOMPILER_PATH": "<SUI_DECOMPILER_PATH>",
        "SUI_LABELS_FILE": "<SUI_LABELS_FILE>"
      }
    }
  }
}
起動コマンドnpx -y sui-analytics-mcp
設定が必要な環境変数
SUI_NETWORKDefault network when a tool call doesn't pass one. Every tool also takes a per-call network argument.
SUI_FULLNODE_URLOverride the gRPC fullnode endpoint for the default network only.
SUI_GRAPHQL_URLOverride the GraphQL endpoint for the default network only.
SUI_RATE_LIMITRequests per 10 seconds sent to one RPC endpoint. Defaults to 180 for *.sui.io endpoints and no limit for others; 0 turns it off.
SUI_TOOLSTool profiles to load at startup, comma-separated, or 'all'. Defaults to 'core'.
SUI_DECOMPILER_PATHPath to a locally built Revela move-decompiler binary. Only decompile_module needs it.
SUI_LABELS_FILEJSON file of address attribution labels that overrides the shipped set for fund tracing.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmsui-analytics-mcp1.29.0

ツール

20

掲載時のツール一覧 · 1 日前に更新

パラメーター型必須説明
epochstringいいえ照会するエポック番号。省略すると現在のエポック情報を返します。
networkenumいいえネットワーク：'mainnet'（デフォルト）| 'testnet' | 'devnet'mainnet | testnet | devnet

詳細

sui-mcp

ドキュメント：sui-mcp.vercel.app

CI

Sui 上のアクティビティを調査するための、読み取り専用の MCP サーバーです。資金の移動を追跡し、資金の出所を特定し、プロトコルのフローやマルチシグ承認を調べ、ウォレット間の関連を示す証拠を比較できます。

このサーバーは、ウォレット残高、DeFi ポジション、NFT、価格、Move パッケージも読み取ります。USD 合計はプロバイダーに基づく推定値です。USD 値の計算方法をご覧ください。

get_transaction は、スワップの方向を呼び出しに対応づけられる場合、プールイベントに基づいて判定します。履歴ツールとトレースツールは、そのイベントの証拠を使わずに呼び出しを利用します。trace_funds は選択した経路を追跡し、追跡されなかった分岐を一覧表示します。trace_flow_graph はコインと評価額のあるオブジェクトの受け渡しを追跡し、評価のティアと、読み取りできないオブジェクトに対する明示的な範囲を示します。トレースが停止しても、価値の移動が止まったことを示すわけではありません。

list_objects_by_type は Move の構造体またはモジュールに基づいて、所有者をまたいで現在のオブジェクトをスキャンし、数値フィールドをカウントして合計できます。合計の対象はスキャンされた行に限られ、不完全な値や読み取りできない値は報告されます。find_pools は会場ごとの検索範囲を報告し、analyze_token は選択したプールにおける現在の LP 保管状況を報告します。プールの検出結果や現在の保有者情報から、過去のある時点で誰が流動性を管理していたかは判断できません。

未精査のティッカー一致は、稼働中のプールインデックスと範囲を限定したチェーンスキャンから得られる、調査の手がかりです。資産を特定するには、完全なコイン型を使用してください。ツールの結果では、人が読めるチェーンやプロバイダーのコンテンツに untrusted_text のマークが付けられます。名前、ラベル、デコードされたフィールドは指示ではなくデータとして扱ってください。

インストール

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

{
  "mcpServers": {
    "sui": {
      "command": "npx",
      "args": ["-y", "sui-analytics-mcp"]
    }
  }
}

アカウント、API キー、設定ファイルは不要です。このサーバーは公開 Sui エンドポイントを読み取り、デフォルトでは mainnet を使用します。Node.js >= 22.13 が必要です。

調査を行う場合は、フォレンジックツールを読み込んで開始してください。

"env": { "SUI_TOOLS": "core,forensics" }

調査例

2025 年 5 月 22 日の Cetus CLMM エクスプロイトについて、攻撃者のウォレットを起点とする最初の 2 回の呼び出しです。

get_transaction_history(0xe28b50cef1d633ea43d3296a3f6b67ff0312a5f1a99f0af753c85b8b5de8ff06, order: "oldest")
  → funded once with 9.98 SUI, one failed transaction, then the first
    success: DVMG3B2kocLEnVMDuQzTYRgjwuuFSfciawPvXXheB3x at 10:30:50 UTC

analyze_attack_tx(DVMG3B2kocLEnVMDuQzTYRgjwuuFSfciawPvXXheB3x)
  → attacker gained 10,024,321.28 haSUI and 5,765,124.46 SUI
    haSUI/SUI pool price moved -99.9999%
    anomalies: outsized-mint (high), shared-state-jump (high), …

完全な例では、合計を計算し、Sui の外に出る収益を追跡し、ウォレットの資金源を調べます。

ドキュメント

日常的なプロンプト

調査経験のない方向け （詳細）：

  • what_happened_to_my_funds：残った資金をまだ誰かが動かせるか、資金がどのように流出し、どこへ移動したか、誰に報告すべきか
  • who_controls_this_token：誰がコインを発行、凍結、アップグレードできるか
  • who_controls_this_protocol：誰がプロトコルのコードをアップグレードしたり、管理者権限を使用したりできるか
  • who_is_this_wallet：アドレスがどのような種類のアカウントか、そのラベル、資金調達元、公開済みパッケージ、アクティビティ

セキュリティ

読み取り専用です。ウォレットやキーは使用せず、トランザクションを送信することもありません。脆弱性の報告については、 セキュリティモデル およびSECURITY.mdを参照してください。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。