Chimera Scaffold

@recon-fuzz-mcp/chimera

用于为 Solidity 智能合约搭建 Chimera 模糊测试套件的 MCP 服务。可生成包含属性、处理器和模糊测试器配置的即用型可编译项目。

工具

工具	输入	返回内容
scaffold_project	contract_name, functions[]	完整的 Chimera 项目（Setup、Properties、TargetFunctions、BeforeAfter、CryticTester 及配置）
generate_properties	contract_source, protocol_type	8-15 个精选不变量属性及 Solidity 框架代码
get_template	template_name	适用于标准协议类型的完整即用型可编译 Chimera 项目
explain_pattern	pattern_name	详细说明及代码示例

协议类型

erc20、vault、lending、amm、governance、staking

模式

actors、ghosts、cross-contract、setup-layering

安装

Claude Code

claude mcp add chimera-scaffold -- npx @recon-fuzz-mcp/chimera

Claude Desktop

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

{
  "mcpServers": {
    "chimera-scaffold": {
      "command": "npx",
      "args": ["@recon-fuzz-mcp/chimera"]
    }
  }
}

Cursor

添加到项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "chimera-scaffold": {
      "command": "npx",
      "args": ["@recon-fuzz-mcp/chimera"]
    }
  }
}

无需 API 密钥。此服务完全在本地运行，不会发起网络请求。

本地开发

git clone https://github.com/Recon-Fuzz/recon-mcp-chimera.git
cd recon-mcp-chimera
npm install
npm run build

测试是否正常运行

# List tools
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

# Scaffold a vault project
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"scaffold_project","arguments":{"contract_name":"SimpleVault","functions":["deposit(uint256)","withdraw(uint256)"]}},"id":2}' | node dist/index.js

# Get a lending template
echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_template","arguments":{"template_name":"lending"}},"id":3}' | node dist/index.js

架构

• 不会发起网络请求——所有内容都由内存中的模板和字符串生成完成
• src/templates/base.ts — Solidity 文件生成器（Setup、BeforeAfter、Properties、TargetFunctions、CryticTester）
• src/templates/configs.ts — 模糊测试器配置生成器（foundry.toml、echidna.yaml、medusa.json）
• src/properties/ — 按协议类型整理的精选属性目录（每种类型包含 8-15 个属性）
• src/patterns/ — 模式说明及完整 Solidity 代码示例
• src/tools/ — MCP 工具实现

隐私

此服务完全离线运行。不会发起网络请求，不会读取环境变量，不会向磁盘写入数据，也不会收集遥测数据。所有模板均在进程内生成。