# Frida Mobile MCP

MCP-сервер Frida Mobile MCP даёт агенту динамический анализ Android и iOS через Frida: хуки, трейсинг вызовов, поиск секретов в памяти, обход SSL pinning.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21 у репозитория
- Автор: monkeywave
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/monkeywave/frida-mobile-mcp
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/frida-mobile-mcp

## Что делает

Сервер надстраивается над Frida 17 и выставляет 71 инструмент. Верхний уровень сам находит устройство и сессию: запускает приложение в подвешенном состоянии, ставит хук на метод Java, ObjC или нативную функцию, обходит память в поисках секретов. Ниже лежат примитивы: spawn и attach, перебор модулей и символов, разрешение адресов, дампы памяти.

Адреса записываются как `module+0xoffset`, в той же нотации, что у Ghidra и IDA, поэтому находка из статики переносится в живой процесс без пересчёта. Каждый ответ идёт с конвертом доказательств: `evidence_id`, `limitations`, `coverage`. Мосты `frida-java-bridge` и `frida-objc-bridge` вложены в пакет, потому что в Frida 17 их убрали из рантайма; `validate_script` отдельно ругается на вызовы, которые в этой версии падают.

Нужен Node.js 22.12 или новее и устройство с frida-server 17.x. Мажорная версия должна совпадать с frida-node 17.24.3, иначе подключения не будет: `frida-mobile-mcp doctor` печатает обе версии и подсвечивает расхождение. Для `capture_tls` есть опция `pip install friTap`, без неё агент скачается при первом вызове.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `FRIDA_DEVICE_ID`, `FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS`, `FRIDA_MCP_MEMORY_WRITE`, `FRIDA_MCP_REMOTE`, `FRIDA_MCP_SCHEMA_PROFILE`, `FRIDA_MCP_MAX_RESPONSE_CHARS`, `FRIDA_MCP_HTTP_TOKEN`, `FRIDA_MCP_RUNTIME`, `FRIDA_MCP_DEBUG`, `FRIDA_MCP_BRIDGES_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> --env FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> --env FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> --env FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> --env FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> --transport stdio frida-mobile-mcp -- npx -y frida-mobile-mcp
```
Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add frida-mobile-mcp --env FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> --env FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> --env FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> --env FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> --env FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> -- npx -y frida-mobile-mcp
```
Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frida-mobile-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "frida-mobile-mcp"
            ],
            "env": {
                "FRIDA_DEVICE_ID": "<FRIDA_DEVICE_ID>",
                "FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS": "<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS>",
                "FRIDA_MCP_MEMORY_WRITE": "<FRIDA_MCP_MEMORY_WRITE>",
                "FRIDA_MCP_REMOTE": "<FRIDA_MCP_REMOTE>",
                "FRIDA_MCP_SCHEMA_PROFILE": "<FRIDA_MCP_SCHEMA_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "frida-mobile-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "frida-mobile-mcp"
            ],
            "env": {
                "FRIDA_DEVICE_ID": "<FRIDA_DEVICE_ID>",
                "FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS": "<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS>",
                "FRIDA_MCP_MEMORY_WRITE": "<FRIDA_MCP_MEMORY_WRITE>",
                "FRIDA_MCP_REMOTE": "<FRIDA_MCP_REMOTE>",
                "FRIDA_MCP_SCHEMA_PROFILE": "<FRIDA_MCP_SCHEMA_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e FRIDA_DEVICE_ID=<FRIDA_DEVICE_ID> -e FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS=<FRIDA_MCP_ALLOW_CUSTOM_SCRIPTS> -e FRIDA_MCP_MEMORY_WRITE=<FRIDA_MCP_MEMORY_WRITE> -e FRIDA_MCP_REMOTE=<FRIDA_MCP_REMOTE> -e FRIDA_MCP_SCHEMA_PROFILE=<FRIDA_MCP_SCHEMA_PROFILE> frida-mobile-mcp npx -y frida-mobile-mcp
```
Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера

## Когда брать
- поставить хук на Java-метод и увидеть аргументы вызова
- вытащить секреты из памяти и сохранить их как шаблоны friTap
- обойти SSL pinning и снять TLS-ключи
- пройти по UI и замерить покрытие достижимости
- перенести адрес из Ghidra в запущенный процесс

## Примеры запросов агенту
- Запусти приложение и покажи загруженные классы с методами
- Поставь хук на `com.example.Login.check` и выведи аргументы
- Сними дамп памяти по адресу `libnative.so+0x1a2c` и покажи содержимое

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
