Skip to main content
Glama
EVM MCP Auditor

EVM MCP Auditor

by zalana28

🛡️ EVM MCP Auditor

CI Test Suite License: MIT MCP Protocol Solidity TypeScript

Produktionsreifer Model Context Protocol (MCP)-Server für Sicherheitsaudits von EVM-Smart-Contracts, statische Schwachstellenanalyse und Multi-Chain-Telemetrie für Claude & Claude Code.


⚡ Überblick

EVM MCP Auditor verbindet Claude, Claude Desktop und Claude Code CLI von Anthropic direkt mit Ethereum- und EVM-Ökosystemen. Es stattet Claude mit spezialisierten Sicherheitsaudit-Tools aus, um Solidity-Smart-Contracts automatisch auf kritische Angriffsvektoren zu untersuchen, verifizierten Quellcode von Block-Explorern abzurufen, rohes Transaktions-Calldata zu decodieren und Multi-Chain-Gaskosten zu schätzen.

┌───────────────────────────┐         ┌───────────────────────────────┐
│                           │  stdio  │                               │
│  Claude Desktop / Code    │ ◄─────► │  EVM MCP Auditor Server       │
│  (Anthropic AI)           │         │  (@zalana/evm-mcp-auditor)    │
│                           │         │                               │
└───────────────────────────┘         └──────────────┬────────────────┘
                                                     │
                                                     ▼
                                      ┌───────────────────────────────┐
                                      │  EVM Networks & Explorers     │
                                      │  • Ethereum • Base • Arbitrum │
                                      │  • Optimism • Polygon • BSC   │
                                      └───────────────────────────────┘

Related MCP server: solidit-mcp-server

🚀 Funktionen & MCP-Tools

MCP-Tool

Beschreibung

evm_audit_contract

Führt eine statische Sicherheitsanalyse von Solidity-Code durch (Reentrancy, Unsicherer Delegatecall, tx.origin-Authentifizierung, Ungeprüfte Aufrufe, Timestamp-Abhängigkeit, Selfdestruct).

evm_fetch_source

Ruft verifizierten Vertragsquellcode direkt von Block-Explorern aus 6 EVM-Netzwerken ab.

evm_decode_calldata

Decodiert rohe Transaktions-Hexdaten in 4-Byte-Funktionsselektoren und Parameterblöcke.

evm_estimate_gas

Ruft Echtzeit-Gas-Telemetrie für Ethereum, Base, Arbitrum, Polygon, Optimism und BSC ab.


📦 Schnellstart & Installation

Option 1: Integration mit Claude Desktop

Fügen Sie den folgenden Codeausschnitt zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "evm-auditor": {
      "command": "npx",
      "args": ["-y", "@zalana/evm-mcp-auditor"]
    }
  }
}

Option 2: Claude Code CLI

claude mcp add evm-auditor npx -y @zalana/evm-mcp-auditor

Option 3: Lokale Entwicklung

# Clone repository
git clone https://github.com/zalana28/evm-mcp-auditor.git
cd evm-mcp-auditor

# Install dependencies
npm install

# Run automated test suites
npm test

# Build TypeScript to dist/
npm run build

# Run local MCP server
npm start

🛡️ Unterstützte Schwachstellen-Scanner (SWC / CWE)

  • EVM-SEC-001: Reentrancy (Verstoß gegen das Checks-Effects-Interactions-Prinzip) SWC-107 / CWE-841

  • EVM-SEC-002: Beliebiger / Unkontrollierter Delegatecall SWC-112 / CWE-829

  • EVM-SEC-003: Unsichere Authentifizierung über tx.origin SWC-115 / CWE-287

  • EVM-SEC-004: Ungeprüfter Rückgabewert eines Low-Level-Aufrufs SWC-104 / CWE-252

  • EVM-SEC-005: Block-Timestamp-Manipulation SWC-116 / CWE-330

  • EVM-SEC-006: Veraltetes selfdestruct / Ungeschützte Zustandssperre SWC-106 / CWE-284

  • EVM-SEC-007: Floating-Pragma-Compilerwarnung SWC-103 / CWE-664

  • EVM-SEC-008: Fehlende Validierung der Zero-Adresse (address(0)) in Setter-Funktionen SWC-100 / CWE-20


🤝 Mitwirken

Beiträge, Issues und Feature-Wünsche sind willkommen! Bitte sehen Sie sich den Mitwirkungsleitfaden an.

📄 Lizenz

Dieses Projekt steht unter der MIT-Lizenz.


Erstellt mit ⚡ von Zalana für die globale Open-Source- und Web3-Entwickler-Community.

Available Tools

4 tools
evm_audit_contractA

Audit Solidity smart contract source code for critical security vulnerabilities (Reentrancy, Unsafe Delegatecall, Tx.Origin authentication, Unchecked Calls, etc.) and generate a security score.

Inputs: sourceCode (required), contractName.

evm_decode_calldataA

Decode raw EVM transaction calldata into function selector, parameter segments, and byte length.

Inputs: calldata (required).

evm_estimate_gasB

Get real-time gas price and network execution telemetry across supported EVM networks.

Inputs: chain.

evm_fetch_sourceA

Fetch verified smart contract source code from block explorers across Ethereum, Base, Arbitrum, Optimism, or Polygon.

Inputs: contractAddress (required), chain.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool occupies a completely distinct role: estimating gas, auditing source, fetching source, and decoding calldata. There is zero functional overlap between the four, eliminating any chance of an agent selecting the wrong tool for a given intent.

    Naming Consistency5/5

    All tools follow a flawless 'evm_verb_noun' snake_case convention with no exceptions. The consistent prefix plus action word makes the API predictable and easy to reason about.

    Tool Count5/5

    Four focused tools is perfectly scoped for a specialized auditing server covering the key audit workflow without bloat. It hits the sweet spot of being comprehensive for its domain without unnecessary features.

    Completeness4/5

    The core fetch-source-and-audit workflow is well covered, with useful supporting utilities for gas analysis and calldata decoding. However, there's no way to list past audits, compare versions, or interact with the broader transaction context, which are minor gaps for a full auditing lifecycle.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI coding agents to scan smart contracts and code for vulnerabilities, check against 12 famous-hack patterns, and return public security receipts directly in the IDE.
      4
      18 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects AI assistants to Solodit's 49,000+ blockchain vulnerability database, enabling search, browse, and lookup of audit findings directly from your AI workflow.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query on-chain data across EVM chains like Base, Optimism, Avalanche, Celo, and Arbitrum, including balances, transactions, gas, and smart contract interactions.
      53 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to perform Web3 development operations such as toolchain diagnostics, chain registry queries and live probing, address validation, secret scanning, deployment logging, and standards searches across multiple blockchains.
      33 npm
      MIT