defi-guard-mcp

DeFi Guard MCP

エージェント（またはあなた自身）が署名する前に、DeFi トランザクションやトークンをチェックする安全レイヤーです。Base L2 上で動作します。実行用 MCP の前段に配置されます（連携して動作し、競合するものではありません）。ハニーポット検出、オーナー権限のスキャン、承認による資産流出のチェック、ポジションの健全性、実行可能な価格を、すべて最新のオンチェーン状態から取得します。

API キーは不要です。公開 Base RPC に対してすぐに動作します（BASE_RPC_URL を設定すれば、独自の RPC を使用して高速化できます）。読み取り専用です。キーを保持したり、署名したり、トランザクションを送信したりすることはありません。

署名前にチェックするツール

ツール	確認できること
token_safety_screen	「署名する前に、このトークンを安全に購入・承認できますか？」— ハニーポット検出（実際に売り戻せるか）、実際の往復コスト（手数料と税の両方）、および所有権が放棄されているか（オーナーが健在な場合、税率の変更、一時停止、ミントが可能なことがよくあります）を確認します。リスクを総合的に判定します。
scan_dangerous_capabilities	「オーナーは私に何ができますか？」— デプロイ済みバイトコードをスキャンし、オーナー専用の権限（mint、pause、blacklist、調整可能な手数料／税、最大トランザクション数の制限、取引の切り替え、プロキシの upgradeTo）を検出します。機能の有無を判定するため、エクスプローラーのキーは不要です。
approval_risk	「この承認は危険ですか？」— オーナーが支出者に許可した最新のアローワンスを読み取り、無制限の承認（アローワンスを使い切る資産流出の経路）と、支出者がコントラクトか EOA かを判定します。現在のエクスポージャーは、今すぐ引き出される可能性がある額です。

データツール

ツール	確認できること
aave_position_health	「この Aave V3 ポジションは安全ですか？」— 最新のヘルスファクター、担保／負債額（USD）、LTV、清算しきい値、およびわかりやすいリスクレベル（healthy / elevated / critical / LIQUIDATABLE）を確認します。
quote_swap	「今このスワップを実行したら、実際にいくら戻ってきますか？」— Uniswap V3 QuoterV2 による正確な入力額ベースの見積もりです。4 つすべての手数料ティアから最適なものを選び、ガス代も見積もります。オラクル価格ではなく、実行可能な価格を示します。
token_risk_snapshot	「このトークンを売却できますか？」— ERC-20 メタデータに加え、2 つの取引サイズで往復見積もり（WETH → トークン → WETH）を行い、実際の市場の厚みを測定します。往復時の損失が大きい場合は、チャート上の表示にかかわらず、流動性が薄いか、売却できない状態です。

「流動性」数値ではなく往復時の厚みを使う理由

TVL やプールサイズの数値は、簡単に偽装でき、誤解も招きやすいものです。最新の状態に対する往復見積もりでは、最も重要なこと、つまり今すぐ購入して売却したときに失う額（往路と復路の両方の手数料と価格への影響）を測定できます。トークンを購入できても売却できない場合、このツールはそのように表示します（UNTRADABLE）。

インストール

npx @iniit/defi-guard-mcp        # or from source: npm install && npm run build

Claude Code

claude mcp add defi-guard -- npx -y @iniit/defi-guard-mcp

任意の MCP クライアント（Cursor、Windsurf など）

{
  "mcpServers": {
    "defi-guard": {
      "command": "npx",
      "args": ["-y", "@iniit/defi-guard-mcp"],
      "env": { "BASE_RPC_URL": "https://your-rpc-if-you-have-one" }
    }
  }
}

BASE_RPC_URL は任意です。設定しない場合、サーバーはフォールバックと再試行を自動で行いながら、複数の公開 Base エンドポイントを順番に使用します。

使用例

「TOKEN X をこのルーターに承認する前に、リスクがないか確認してもらえますか？」

エージェントは token_safety_screen（売り戻せるか、所有権が放棄されているか）、scan_dangerous_capabilities（オーナーがミント／ブラックリスト登録／一時停止できるか）、approval_risk（EOA に対する無制限のアローワンスか）を呼び出し、感覚ではなく最新のオンチェーン情報に基づいて、署名前に回答します。

注意事項（必ずお読みください）

• 見積もりは最新の状態に対するシミュレーション（eth_call）です。実際の実行では、見積もりからブロックへの取り込みまでの間にスリッページが発生します。
• コントラクトアドレス（Aave V3 Pool、QuoterV2）は Base メインネットの定数であり、最新のチェーン状態に対して検証されています。
• これは読み取り専用のツールです。キーを保持したり、署名したり、トランザクションを送信したりすることはありません。
• 金融アドバイスではありません。オンチェーンの状態を報告しますが、判断はご自身で行ってください。

テスト

npm run build   # tsc — type-checks and emits dist/. Tools are verified against live Base state.

ライセンス

MIT