Melakukan analisis terstruktur pada bytecode runtime EVM yang telah di-deploy untuk mengekstrak function selector, akses storage, dan control-flow graph.
Juga dikenal sebagai cdump/evmole, evmole-mcp
- Stars
- 474
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.9.4
- Commit terakhir
- 10 Nov 2026
- Lisensi
- MIT
Apa itu EVMole MCP?
EVMole adalah MCP server. Melakukan analisis terstruktur pada bytecode runtime EVM yang telah di-deploy untuk mengekstrak function selector, akses storage, dan control-flow graph.
Ringkasan dibuat dari README proyek
Tentang EVMole MCP server
Menganalisis bytecode runtime EVM yang sudah di-deploy untuk mengekstrak data terstruktur adalah fungsi utama EVMole bagi developer yang menggunakan agent kompatibel MCP. Dengan menjalankan local server ini via npx, Anda dapat memberikan hexadecimal bytecode ke tool analyze_evm_bytecode untuk mengungkap detail kontrak yang tersembunyi. Server ini beroperasi sepenuhnya melalui stdio dan tidak memerlukan API key, kredensial, atau akses jaringan, sehingga memastikan analisis bytecode Anda tetap privat di mesin lokal Anda.
Developer dapat menggunakan tool ini untuk mengambil function selector, lokasi dispatch, serta inferensi argumen atau state mutability. Tool ini juga memberikan wawasan mengenai akses storage yang bersifat persistent maupun transient, metadata compiler, dan control-flow graph. Karena disassembly dan basic blocks dapat menghasilkan output yang besar, fitur-fitur tersebut bersifat opt-in. Tool ini mengembalikan konten terstruktur berdasarkan format respons EVMole versi 1 yang kanonik, sehingga memungkinkan agent untuk menginterpretasikan perilaku kontrak secara terprogram tanpa memerlukan source code aslinya.
Apa yang bisa Anda lakukan dengannya
- 1Identifikasi signature fungsi kontrakMinta agent untuk mengekstrak function selector dan lokasi dispatch dari string hex yang diberikan.
- 2Memetakan pola interaksi storageMinta analisis mengenai bagaimana sebuah kontrak berinteraksi dengan domain storage persistent dan transient.
- 3Visualisasi logika eksekusi kontrakBerikan bytecode untuk menghasilkan control-flow graph dan disassembly guna inspeksi yang lebih mendalam.
- 4Inferensi state mutability kontrakTentukan apakah fungsi tertentu ditujukan untuk memodifikasi state dari kontrak tersebut.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal EVMole MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal EVMole MCP di Claude Code
$ claude mcp add evmole -- npx -y evmole-mcpInstal EVMole MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Instal EVMole MCP di VS Code
.vscode/mcp.json
{
"servers": {
"evmole": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Instal EVMole MCP di VS Code CLI
$ code --add-mcp '{"name":"evmole","type":"stdio","command":"npx","args":["-y","evmole-mcp"]}'Instal EVMole MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Instal EVMole MCP di Codex
$ codex mcp add evmole -- npx -y evmole-mcpInstal EVMole MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.evmole] command = "npx" args = ["-y", "evmole-mcp"]
Instal EVMole MCP di Gemini CLI
$ gemini mcp add -s user evmole npx -- -y evmole-mcpInstal EVMole MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"evmole": {
"command": "npx",
"args": [
"-y",
"evmole-mcp"
]
}
}
}Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di 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.
Pertanyaan tentang EVMole MCP
Bagaimana cara menambahkan EVMole MCP ke Claude Code?
Jalankan claude mcp add evmole -- npx -y evmole-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan EVMole MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa saja yang bisa diekstrak dari bytecode EVM menggunakan tool ini?
Tool ini dapat mengekstrak function selector, lokasi dispatch, inferensi argumen, state mutability, akses storage, metadata compiler, disassembly, dan control-flow graph.
Apakah MCP server ini melakukan request jaringan atau memerlukan kredensial?
Tidak, server ini hanya menggunakan stdio, tidak melakukan request jaringan, dan tidak memerlukan kredensial apa pun.
Apa saja batasan dari analisis ini?
Tool ini tidak melakukan decode calldata, tidak memverifikasi source code, tidak mengeksekusi creation bytecode, dan tidak melakukan dekompilasi source code secara penuh.