WormaCeptor — Claude Code MCP server: features and setup
WormaCeptor lets an agent inspect a running Android debug app, including its requests, crashes, logs and storage. Use it to investigate app issues without pasting logs into chat.
claude mcp add wormaceptor -- npx -y wormaceptor-mcpWhat WormaCeptor does
WormaCeptor connects an MCP client to a running Android app in a debug build. Its 44 tools cover network activity, crashes, logs, performance and storage, so an agent can examine what the app and its services are doing during a debugging session.
Add wormaceptor-mcp-server with debugImplementation, configure the app-side components, then register the server with your client. The npx launcher needs Node.js 18+, Java 17+ and adb. The bridge cannot reach the app without those components. It connects through adb forward; Bearer-token authentication is off by default, which matters when using a shared device.
Features can be enabled individually during initialization. Release builds omit the debug implementation, and the client falls back to a no-op. MCP inspection is therefore limited to debug builds.
What it helps with
- trace a request that returned an error
- read crash details alongside app logs
- inspect SQLite and SharedPreferences data
- check app performance metrics
- replay a request or configure a mock
Example prompts for the agent
- Inspect the app's network requests and find the response that failed.
- Read the latest crash report and check the related logs.
- Show the SharedPreferences entries and inspect the setting value.
How to install WormaCeptor
Platform CLI
claude mcp add wormaceptor -- npx -y wormaceptor-mcpPlatform CLI
codex mcp add npx -- npx -y wormaceptor-mcpConfig file
{
"mcpServers": {
"npx": {
"command": "npx",
"args": [
"-y",
"wormaceptor-mcp"
]
}
}
}Config file
{
"servers": {
"npx": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wormaceptor-mcp"
]
}
}
}Platform CLI
gemini mcp add npx npx -y wormaceptor-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WormaCeptor
How do I install WormaCeptor in Claude Code?
Register it with claude mcp add wormaceptor -- npx -y wormaceptor-mcp. The npx launcher requires Node.js 18+, Java 17+ and adb; add the MCP module to the Android app with debugImplementation as well.
What does WormaCeptor do?
It gives an MCP client access to a running Android debug app, including its network activity, crashes, logs, performance data and storage.
What does the app need for MCP access?
The npx bridge requires Node.js 18+, Java 17+ and adb. The app's MCP module is added to debug builds.
