io.github.crissyfield/super-trouper

Super Trouper

An MCP server for the Frida reverse engineering toolkit.

Super Trouper runs an MCP server over STDIO that exposes Frida capabilities as tools for coding agents. It can connect to local, USB, and remote devices; inspect applications and processes; manage process sessions; and load, evaluate, and exchange messages with JavaScript instrumentation scripts. It can also search Frida CodeShare to discover community scripts and fetch them for use with the scripting tools. Device connections, sessions, and scripts are managed through the tools themselves and referenced by opaque handles.

Features

• Single Go binary — no Python, Node, or Frida CLI tooling required on your host
• Powered by Frida 17.x — statically linked against Frida Core DevKit v17.18.0
• Full device support — list and connect to local, USB, and remote devices, attach to apps and processes
• TypeScript and JavaScript instrumentation — create and load Frida scripts, evaluate directly in a target
• Frida CodeShare integration — search, browse, and fetch the CodeShare catalog of community scripts
• Runs anywhere — prebuilt binaries for macOS and Linux, install via Docker, Homebrew, or npm

Install

Homebrew

Install the macOS release through the project’s Homebrew tap:

brew install --cask crissyfield/tap/super-trouper

npm

Install the launcher package through npm. It pulls in the platform-specific binary via optional dependencies:

npm install -g @crissyfield/super-trouper

Release Binary

Download a binary for your platform from the Releases page.

From Source

Install a Frida Core DevKit matching your build host first. Then build and install Super Trouper with the following commands:

# Set flags if the Frida devkit is not in a standard location
export CGO_CFLAGS="-I..path/to/frida-core-devkit/include"
export CGO_LDFLAGS="-L..path/to/frida-core-devkit/lib"

# Build and install
export CGO_ENABLED=1
go install github.com/crissyfield/super-trouper@latest

Usage

Use the MCP server in your coding agent. Claude Code is the example below, but configuration is similar in Codex, OpenCode, Pi, Crush, and others.

Using the Binary

If the Super Trouper binary is not in your PATH, specify the full path in your MCP server configuration.

{
  "mcpServers": {
    "super-trouper": {
      "command": "super-trouper"
    }
  }
}

Using npx

npm users can run Super Trouper directly through npx without a global installation:

{
  "mcpServers": {
    "super-trouper": {
      "command": "npx",
      "args": ["-y", "@crissyfield/super-trouper"]
    }
  }
}

Using Docker

Docker is a convenient way to run Super Trouper without installing it on your host.

{
  "mcpServers": {
    "super-trouper": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/crissyfield/super-trouper"]
    }
  }
}