RugShield 402

RugShield 402 🛡️ — DEX セキュリティとハニーポット検出のためのオープンソース MCP サーバー

このリポジトリには、RugShield 402 のオープンソース Model Context Protocol（MCP）サーバー実装がすべて含まれています。LLM、自律型取引エージェント、IDE（Claude Desktop、Cursor、Windsurf）に、トークンの購入・売却シミュレーション、ハニーポットの罠の分析、正確な送金税率の計算、Base および EVM ネットワーク上の DEX 流動性の深さの検証を行うツールを提供します。

---

🛠️ 実装済みの MCP ツール

この MCP サーバーは、標準の stdio およびストリーミング可能な HTTP トランスポート経由で、以下のツールを提供します。

ツール名	説明	主なパラメーター
rugshield_pre_swap_scan	取引前の包括的なスワップシミュレーションです。ハニーポット、悪意のある送金制限、流動性を引き抜く罠を検出します。	token_address（文字列、42 文字の16進数）、simulate_sell（ブール値、デフォルト：true）
check_honeypot	トークンのバイトコードを逆コンパイルし、Base RPC に対して購入・売却テストを実行します。購入・売却税の正確な値（ベーシスポイント、bps）、ブラックリストの確認結果、リスクスコアを返します。	token_address（文字列、42 文字の16進数）
verify_liquidity_lock	DEX プールの準備金（Uniswap v3、Aerodrome）、LP トークンのロック状態、ボンディングカーブの状態、流動性の総額（米ドル）を分析します。	token_address（文字列、42 文字の16進数）
detect_holder_clusters	上位トークン保有者の分布をマッピングし、シビルウォレットのクラスターを検出して、開発者の保有集中リスクを算出します。	token_address（文字列、42 文字の16進数）

---

🚀 ソースから実行する（ローカルの Stdio トランスポート）

Node.js と Model Context Protocol SDK を使い、ソースコードからこの MCP サーバーをお使いのマシン上でローカルに実行できます。

1. インストールとビルド

# Clone the open-source repository
git clone https://github.com/ak10082247-max/rugshield-402.git
cd rugshield-402

# Install dependencies
npm install

# Build the TypeScript source code
npm run build

2. Claude Desktop の設定

このサーバーを claude_desktop_config.json に追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rugshield-402": {
      "command": "node",
      "args": [
        "/absolute/path/to/rugshield-402/dist/mcp/server.js"
      ]
    }
  }
}

または、開発中にビルドせず、tsx で直接実行します。

{
  "mcpServers": {
    "rugshield-402": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/absolute/path/to/rugshield-402/src/mcp/server.ts"
      ]
    }
  }
}

3. Cursor または Windsurf の設定

ワークスペースの .cursor/mcp.json または Windsurf の MCP 設定に追加します。

{
  "mcpServers": {
    "rugshield-402": {
      "command": "node",
      "args": ["dist/mcp/server.js"]
    }
  }
}

---

🌐 ホストされたリモート MCP エンドポイントへの接続

ローカルの依存関係なしでホストされたクラウドインスタンスに接続する場合、RugShield は高可用性のクラウドインフラストラクチャ上で24時間365日稼働しています。

• リモート MCP URL：https://rugshield-402.onrender.com/mcp
• プロトコル：Model Context Protocol（ストリーミング可能な HTTP / SSE JSON-RPC 2.0）
• ディスカバリーマニフェスト：https://rugshield-402.onrender.com/.well-known/mcp/server-card.json
• x402 マニフェスト：https://rugshield-402.onrender.com/.well-known/x402.json

---

🏛️ シミュレーションエンジンのアーキテクチャ

sequenceDiagram
    autonumber
    actor LLM as Claude / Agent / Cursor
    participant MCP as RugShield MCP Server (Local / Remote)
    participant Simulator as EVM Bytecode Simulator
    participant Base as Base Mainnet RPC
    participant DEX as Aerodrome / Uniswap v3

    LLM->>MCP: tools/call ("rugshield_pre_swap_scan", { token_address })
    MCP->>Simulator: Fork State & Simulate Buy/Sell
    Simulator->>Base: Fetch Bytecode, Balances & Storage Slots
    Simulator->>DEX: Simulate Swap on Liquidity Pool
    Simulator-->>MCP: Honeypot Verdict, Tax Rates, Risk Score
    MCP-->>LLM: Structured JSON Analysis & Safety Attestation

---

📦 開発者向け SDK とフレームワーク連携

RugShield は、自動化されたマルチエージェントフレームワーク向けにパッケージ化されており、ガス代不要の自律的な支払い決済を100％実現します（ETH も SOL も不要です）。

1. 自律エージェントの自動支払いクイックスタート（TypeScript）

@x402/fetch で標準の fetch をラップすると、HTTP 402 チャレンジに自動対応し、Base 上で EIP-712 の送金承認に署名して、15ms 未満で再試行できます。

npm install @x402/fetch @x402/core @x402/evm viem

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:8453", new ExactEvmScheme(account));

// 1-line wrapper automatically signs & unlocks full 100% honeypot simulation
const xFetch = wrapFetchWithPayment(fetch, client);
const res = await xFetch("https://rugshield-402.onrender.com/v1/scan", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ token_address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", simulate_sell: true }),
});
const report = await res.json();
console.log("Full Verified Analysis:", report);

2. 自律型エージェントの自動支払いクイックスタート（Python）

組み込みの Python クライアント（sdk/python/rugshield.py）を使用します。

from rugshield import RugShieldClient

# Pass your agent wallet private key - automatically handles 402 challenges & EIP-712 signing
client = RugShieldClient(private_key="0xYOUR_AGENT_PRIVATE_KEY")
report = client.scan_token("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")

print(f"Honeypot: {report.get('is_honeypot')}")
print(f"Exact Sell Tax: {report.get('sell_tax_bps')} bps")

3. ElizaOS 自律型エージェントプラグイン

npm install @kurox_real/plugin-rugshield-402

import { rugshieldPlugin } from "@kurox_real/plugin-rugshield-402";

export const character = {
  name: "AutonomousDeFiTrader",
  plugins: [rugshieldPlugin],
};

4. Coinbase AgentKit（LangChain / Python / TS）

npm install @kurox_real/agentkit-rugshield-402

import { rugshieldActionProvider } from "@kurox_real/agentkit-rugshield-402";
import { AgentKit } from "@coinbase/agentkit";

const agentKit = await AgentKit.from({
  actionProviders: [rugshieldActionProvider()],
});

5. 直接 REST API（cURL）

# Returns 402 with structured 50% free preview + unlock instructions:
curl -X POST https://rugshield-402.onrender.com/v1/scan \
  -H "Content-Type: application/json" \
  -d '{"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "simulate_sell": true}'

---

💳 オプションのクラウドサブスクリプション（MCPize / Apify）

セルフホストではなく、毎月定額のクレジットカード請求で、すぐに利用できるマネージドインフラストラクチャをお探しのチーム向け：

• MCPize Directory：mcpize.com/dashboard から接続できます
• Apify Pay-Per-Event：apify.com でアクターを配布できます

---

📄 ライセンス

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