unidbg

Позволяет эмулировать нативные библиотеки Android, а также экспериментально поддерживает эмуляцию iOS.

Это учебный проект для изучения форматов файлов ELF/MachO и ассемблера ARM.

Используйте на свой страх и риск!

Возможности

• Поддержка MCP (Model Context Protocol) для AI-assisted отладки в Cursor и других AI-инструментах.
• Эмуляция JNI Invocation API с возможностью вызова JNI_OnLoad.
• Поддержка JavaVM, JNIEnv.
• Эмуляция инструкций syscall.
• Поддержка ARM32 и ARM64.
• Inline-хуки через Dobby.
• Android import hook через xHook.
• iOS-хуки: fishhook, substrate и whale.
• Бэкенд unicorn: консольный отладчик, gdb stub, трассировка инструкций, трассировка чтения/записи памяти.
• Поддержка iOS objc и swift runtime.
• Быстрый бэкенд dynarmic.
• Поддержка гипервизора Apple M1 — самый быстрый бэкенд для ARM64.
• Поддержка бэкенда Linux KVM на Raspberry Pi B4.
• Обнаружение утечек памяти в эмулируемом нативном коде с backtrace гостя и стектрейсом хоста.

MCP-отладчик (интеграция с AI)

unidbg поддерживает Model Context Protocol (MCP) для AI-assisted отладки. Когда отладчик активен, введите mcp в консоли, чтобы запустить MCP-сервер, к которому могут подключаться AI-инструменты (например, Cursor).

Быстрый старт

unidbg MCP работает в двух режимах:

Режим 1: Отладка по точкам останова — подключите отладчик и запустите код. При срабатывании точки останова Breaker.debug() приостанавливает эмулятор — введите mcp в консоли, чтобы запустить MCP-сервер и позволить AI помочь с анализом. Доступны все инструменты отладки (регистры, память, дизассемблирование, пошаговое выполнение, трассировка и др.). После возобновления, если сработает следующая точка останова, отладчик снова приостановится. Когда выполнение завершится без срабатывания точек останова, процесс завершится и MCP остановится.

Debugger debugger = emulator.attach();
debugger.addBreakPoint(address);
// запустите логику эмуляции — отладчик приостановится при срабатывании точки останова

Режим 2: Пользовательские инструменты (многократный запуск) — используйте McpToolkit для регистрации пользовательских инструментов и позвольте AI повторно запускать целевые функции с разными параметрами. Нативная библиотека загружается один раз; после каждого выполнения процесс остаётся активным, а MCP продолжает работу для следующего запуска.

McpToolkit toolkit = new McpToolkit();
toolkit.addTool(new McpTool() {
    @Override public String name() { return "encrypt"; }
    @Override public String description() { return "Run encryption"; }
    @Override public String[] paramNames() { return new String[]{"input"}; }
    @Override public void execute(String[] params) {
        String input = params.length > 0 ? params[0] : "default";
        // вызов шифрования с input
    }
});
toolkit.run(emulator.attach());

Когда отладчик остановится, введите mcp (или mcp 9239 для указания порта) в консоли. Затем добавьте в настройки MCP в Cursor:

{
  "mcpServers": {
    "unidbg-mcp-server": {
      "url": "http://localhost:9239/sse"
    }
  }
}

Доступные MCP-инструменты

Статус и информация

Регистры и дизассемблирование

Память

Точки останова и выполнение

Трассировка

Вызов функций