Barbatos

Android Runtime Debugger & MCP Server.

"Understanding the language of systems, revealing hidden states, and reconciling the gap between developer and machine."

IMAGEM_AQUI_1

Quick Installation

curl -sSL https://barbatos.victorlpgazolli.dev/install.sh | bashCopy

Recommended for macOS (ARM64), Linux (x64/ARM64), and WSL.

AI-Driven Debugging

Connect Barbatos to your AI agent via the Model Context Protocol (MCP) to automate runtime exploration and manipulation. Your AI assistant can seamlessly:

State Exploration

"Locate the active LoginState instance and tell me the value of its errorCode field."

Method Hooking

"Tell me the parameters passed to the MyViewModel.fetchData method every time it is called."

Live Edit

"Change the isPremium boolean on the active UserProfile instance to true to test the UI state."

Core Capabilities

Class Discovery

Real-time enumeration of loaded Java/Kotlin classes with package filtering.

Deep Inspection

Recursive traversal of object hierarchies including Fields, Maps, and Collections.

Method Hooking

Intercept execution flow, inspect arguments, and capture return values live.

Live Field Editing

Modify primitive field values (String, Int, Boolean) in real-time to test hypotheses.

Architecture Pipeline

Native TUI

MCP Client

↓

Python Bridge

↓

Frida JS Agent

↓

Android Runtime

↓

Target App

MCP Server Setup

Add this to your claude_desktop_config.json:

{
                "mcpServers": {
                    "barbatos-debugger": {
                        "command": "python3",
                        "args": ["/absolute/path/to/barbatos/mcp_server/server.py"]
                    }
                }
            }

Note: Ensure the barbatos-bridge is running (listening on port 8080) before using the MCP tools.