Contract Security Scanner

合约安全扫描器 — MCP 服务

直接通过 AI 助手扫描任意 Base L2 智能合约，检查安全风险。

提供 3 个工具：

• scan_contract — 全面安全扫描（源代码验证、危险选择器、合约年限、活跃度）
• batch_scan — 并排比较最多 5 个合约
• interpret_risk — 获取可执行的建议（SAFE / CAUTION / HIGH_RISK / DO_NOT_USE）

风险评分：0-100。 分析内容：铸币/黑名单/后门函数、代理模式、源代码验证、合约年限、交易活跃度。

---

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "contract-scanner": {
      "command": "node",
      "args": ["/Users/sam/Desktop/samDev/p8/mcp/server.js"]
    }
  }
}

重启 Claude Desktop。工具会自动显示。

---

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "contract-scanner": {
      "command": "node",
      "args": ["/Users/sam/Desktop/samDev/p8/mcp/server.js"]
    }
  }
}

---

Cline（VS Code 扩展）

1. 打开 Cline 设置 → MCP Servers → Add server
2. 设置类型：stdio
3. 命令：node /Users/sam/Desktop/samDev/p8/mcp/server.js

---

任意 MCP 客户端（通用）

该服务使用 stdio 传输 — 只需通过管道传递 JSON-RPC 消息：

node /Users/sam/Desktop/samDev/p8/mcp/server.js

---

使用示例

连接后，只需自然地向 AI 助手提问：

"Scan this contract before I approve: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

"Compare the risk of these 3 Aave clones: 0x... 0x... 0x..."

"Is this token safe to buy? 0x4ed4e862860bed51a9570b96d89af5e1b0efefed"

---

分析内容

检查项	来源
源代码是否已验证？	BaseScan API
铸币 / 销毁函数	字节码选择器扫描
暂停 / 冻结	字节码选择器扫描
黑名单 / 白名单	字节码选择器扫描
后门（rescueTokens、withdrawAll）	字节码选择器扫描
可升级代理	BaseScan + delegatecall 检测
合约年限	BaseScan 交易历史
活跃度	BaseScan 最近交易

---

风险评分

评分	标签	含义
0-9	SAFE	未发现风险信号
10-29	LOW	存在轻微顾虑
30-49	MEDIUM	风险较高 — 交互前请先审查
50-69	HIGH	风险显著 — 仅使用少量资金
70+	CRITICAL	避免使用 — 可能存在 Rug Pull 或后门

---

技术说明

• 链：仅限 Base L2（https://mainnet.base.org）
• API：BaseScan 免费层（基本检查无需密钥；设置 BASESCAN_API_KEY 环境变量以进行完整源代码分析）
• 无需钱包：仅进行只读 RPC 调用
• 延迟：每个合约约 2-5 秒（取决于网络）

---

基于 Base 构建。Agent 钱包：0x804dd2cE4aA3296831c880139040e4326df13c6e