Effectue une analyse structurée du bytecode d'exécution EVM déployé pour extraire les sélecteurs de fonction, l'accès au stockage et les graphes de flux de contrôle.
Aussi connu sous cdump/evmole, evmole-mcp
- Étoiles
- 474
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.9.4
- Dernier commit
- 10 nov. 2026
- Licence
- MIT
Qu'est-ce que EVMole MCP ?
EVMole est un serveur MCP. Effectue une analyse structurée du bytecode d'exécution EVM déployé pour extraire les sélecteurs de fonction, l'accès au stockage et les graphes de flux de contrôle.
Résumé généré à partir du README du projet
À propos du MCP server EVMole
L'analyse du bytecode d'exécution EVM déployé pour en extraire des données structurées est ce qu'EVMole permet aux développeurs utilisant des agents compatibles MCP. En lançant ce serveur local via npx, les utilisateurs peuvent fournir du bytecode hexadécimal à l'outil analyze_evm_bytecode pour révéler des détails cachés sur les contrats. Le serveur fonctionne entièrement via stdio et ne nécessite aucune clé API, aucun identifiant ni aucun accès réseau, garantissant que votre analyse de bytecode reste privée sur votre machine locale.
Les développeurs peuvent utiliser cet outil pour récupérer les sélecteurs de fonction, les emplacements de dispatch ainsi que les arguments déduits ou la mutabilité d'état. Il fournit également des informations sur l'accès au stockage persistant et transitoire, les métadonnées du compilateur et les graphes de flux de contrôle. Comme le désassemblage et les blocs de base peuvent générer des sorties volumineuses, ces fonctionnalités sont optionnelles. L'outil renvoie un contenu structuré basé sur le format de réponse canonique version 1 d'EVMole, permettant aux agents d'interpréter de manière programmatique le comportement du contrat sans avoir besoin du code source original.
Ce que vous pouvez faire avec
- 1Identifier les signatures de fonction des contratsDemandez à l'agent d'extraire les sélecteurs de fonction et les emplacements de dispatch à partir d'une chaîne hexadécimale fournie.
- 2Cartographier les modèles d'interaction avec le stockageDemandez une analyse de la manière dont un contrat interagit avec les domaines de stockage persistant et transitoire.
- 3Visualiser la logique d'exécution du contratFournissez le bytecode pour générer un graphe de flux de contrôle et un désassemblage pour une inspection plus approfondie.
- 4Déduire la mutabilité d'état du contratDéterminez si des fonctions spécifiques sont destinées à modifier l'état du contrat.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer EVMole MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller EVMole MCP dans Claude Code
$ claude mcp add evmole -- npx -y evmole-mcpInstaller EVMole MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Installer EVMole MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"evmole": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Installer EVMole MCP dans VS Code CLI
$ code --add-mcp '{"name":"evmole","type":"stdio","command":"npx","args":["-y","evmole-mcp"]}'Installer EVMole MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Installer EVMole MCP dans Codex
$ codex mcp add evmole -- npx -y evmole-mcpInstaller EVMole MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.evmole] command = "npx" args = ["-y", "evmole-mcp"]
Installer EVMole MCP dans Gemini CLI
$ gemini mcp add -s user evmole npx -- -y evmole-mcpInstaller EVMole MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésNon vérifié
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur GitHubevmole-mcp
evmole-mcp is the local MCP server for
EVMole, a structured analyzer for deployed
EVM runtime bytecode. It exposes one tool, analyze_evm_bytecode, for use by
MCP-compatible agents and clients.
Start the server
npx -y evmole-mcp@latest
Node.js 22 or newer is required.
Configure an MCP client
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": ["-y", "evmole-mcp@latest"]
}
}
}
The server communicates over stdio.
Analyze runtime bytecode
The analyze_evm_bytecode tool accepts hexadecimal bytecode, optional
include feature names, and optional offset and limit values. It can
extract:
- function selectors and dispatch locations;
- inferred arguments and state mutability;
- inferred persistent and transient storage access;
- compiler metadata;
- disassembly, basic blocks, and a control-flow graph.
Function selectors can be requested on their own with selectors. Requesting
arguments or stateMutability also enables selector extraction, and the
requested function information is combined in analysis.functions. Other
requested analyses are returned in their corresponding analysis fields.
If include is omitted, the tool analyzes selectors, arguments, state
mutability, both storage domains, and metadata. Disassembly and control-flow
features are opt-in because their output can be large. The tool returns the
canonical version 1 EVMole response as structured content plus a JSON text
fallback. Check warnings and pagination before interpreting the result.
Privacy and limitations
The server uses stdio only, makes no network requests, requires no credentials, does not fetch contract addresses, and writes no files. It does not decode calldata, verify source, execute creation bytecode, or fully decompile source. Arguments, mutability, and storage descriptions are inferred rather than verified source-level facts.
Each evmole-mcp release depends on the matching exact evmole version.
See https://github.com/cdump/evmole/tree/master/agent for full setup and privacy guidance. Report problems at https://github.com/cdump/evmole/issues.
Questions sur EVMole MCP
Comment ajouter EVMole MCP à Claude Code ?
Exécutez claude mcp add evmole -- npx -y evmole-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter EVMole MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Que peut extraire l'outil du bytecode EVM ?
Il peut extraire les sélecteurs de fonction, les emplacements de dispatch, les arguments déduits, la mutabilité d'état, l'accès au stockage, les métadonnées du compilateur, le désassemblage et les graphes de flux de contrôle.
Ce serveur effectue-t-il des requêtes réseau ou nécessite-t-il des identifiants ?
Non, le serveur utilise uniquement stdio, n'effectue aucune requête réseau et ne nécessite aucun identifiant.
Quelles sont les limites de l'analyse ?
L'outil ne décode pas les calldata, ne vérifie pas le code source, n'exécute pas le bytecode de création et ne décompile pas entièrement le code source.