@recon-fuzz-mcp/chimera

Servidor MCP que crea estructuras (scaffolding) para suites de pruebas de fuzzing con Chimera para contratos inteligentes de Solidity. Genera proyectos listos para compilar con propiedades, manejadores y configuraciones de fuzzer.

Herramientas

Tipos de protocolo

erc20, vault, lending, amm, governance, staking

Patrones

actors, ghosts, cross-contract, setup-layering

Instalación

Claude Code

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

Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor

Añadir a .cursor/mcp.json en su proyecto:

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

No se necesita clave API. El servidor se ejecuta completamente de forma local sin llamadas de red.

Desarrollo local

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

Comprobar que funciona

# 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

Arquitectura

• Sin llamadas de red: todo son plantillas en memoria y generación de cadenas de texto

• src/templates/base.ts — Generadores de archivos Solidity (Setup, BeforeAfter, Properties, TargetFunctions, CryticTester)

• src/templates/configs.ts — Generadores de configuración de fuzzer (foundry.toml, echidna.yaml, medusa.json)

• src/properties/ — Catálogos de propiedades seleccionadas por tipo de protocolo (8-15 propiedades cada uno)

• src/patterns/ — Explicaciones de patrones con ejemplos completos de código Solidity

• src/tools/ — Implementaciones de herramientas MCP

Privacidad

Este servidor se ejecuta completamente sin conexión. No hay llamadas de red, no se leen variables de entorno, no se escriben datos en el disco, no hay telemetría. Toda la generación de plantillas ocurre dentro del proceso.