RugShield 402

RugShield 402 🛡️ — 面向 DEX 安全与蜜罐检测的开源 MCP 服务

此代码库包含 RugShield 402 的完整开源模型上下文协议（MCP）服务实现。它为大模型、自主交易 Agent 和 IDE（Claude Desktop、Cursor、Windsurf）提供工具，用于模拟代币买卖、分析蜜罐陷阱、计算精确的转账税率，以及验证 Base 和 EVM 网络上的 DEX 流动性深度。

---

🛠️ 已实现的 MCP 工具

此 MCP 服务通过标准的 stdio 和可流式传输的 HTTP 传输提供以下工具：

工具名称	描述	关键参数
rugshield_pre_swap_scan	全面的交易前兑换模拟：检测蜜罐、恶意转账限额和流动性抽离陷阱。	token_address（字符串，42 位十六进制），simulate_sell（布尔值，默认值：true）
check_honeypot	反编译代币字节码，并通过 Base RPC 执行买入／卖出测试。返回精确的买入／卖出税率（以基点表示，bps）、黑名单检查结果和风险评分。	token_address（字符串，42 位十六进制）
verify_liquidity_lock	分析 DEX 池储备（Uniswap v3、Aerodrome）、LP 代币锁定状态、联合曲线状态以及总 USD 流动性深度。	token_address（字符串，42 位十六进制）
detect_holder_clusters	映射代币最大持有者的分布，检测 Sybil 钱包集群，并计算开发者持仓集中度风险。	token_address（字符串，42 位十六进制）

---

🚀 从源代码运行（本地 Stdio 传输）

你可以使用 Node.js 和模型上下文协议 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 已部署在高可用云基础设施上，可全天候运行：

• 远程 MCP URL：https://rugshield-402.onrender.com/mcp
• 协议：模型上下文协议（可流式传输的 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 已为自动化多 Agent 框架打包，支持 100% 免 Gas 的自主支付结算（无需 $0 ETH / $0 SOL）：

1. 自主 Agent 自动支付快速入门（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. 自主 Agent 自动付款快速入门（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 自主 Agent 插件

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 目录：通过 mcpize.com/dashboard 连接
• Apify 按事件付费：在 apify.com 分发 Actor

---

📄 许可证

这个开源项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。