Which integrations are available for this server?

Enables building, testing, debugging, and automating [Android](/mcp/servers/integrations/android) applications with tools for device management, UI interaction, crash analysis, app state inspection, and deep linking Provides build automation for Android projects through [Gradle](/mcp/servers/integrations/gradle) build system integration Enables building, testing, debugging, and automating [iOS](/mcp/servers/integrations/ios) applications with tools for simulator management, UI interaction, crash symbolication, app state inspection, and deep linking Provides build automation and tooling for iOS projects through [Xcode](/mcp/servers/integrations/xcode) command line tools and xcodebuild

Specter MCP by abd3lraouf

Overview

Specter MCP enables AI agents to build, test, debug, and interact with Android and iOS applications through a standardized Model Context Protocol (MCP) interface. It provides 15 specialized tools organized into categories for complete mobile development automation.

Features

Build Pipeline — Build, install, and launch apps on Android/iOS
UI Automation — Capture screenshots, UI hierarchies, and perform interactions
Testing — Run unit tests, Maestro E2E flows, and linters
Environment Management — List/boot devices, clean projects
Crash Analysis — Cross-platform crash analysis (iOS crash files + symbolication, Android logcat)
Deep Linking — Navigate apps via deep links with intent extras
App State Inspection — Read preferences, databases, and logs

Quick Start

Installation

npm install -g specter-mcp

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{ "mcpServers": { "specter-mcp": { "command": "specter-mcp" } } }

Restart Claude Desktop. Ask Claude: "List my available Android and iOS devices"

Documentation

Tool Guides

Build Tools — build_app, install_app, launch_app
UI Tools — get_ui_context, interact_with_ui
Testing Tools — run_unit_tests, run_maestro_flow, run_linter
Environment Tools — list_devices, manage_env, clean_project
Observability Tools — analyze_crash, inspect_logs, inspect_app_state, deep_link_navigate

Available Tools

Category	Tools
Build	`build_app` `install_app` `launch_app`
UI	`get_ui_context` `interact_with_ui`
Testing	`run_unit_tests` `run_maestro_flow` `run_linter`
Environment	`list_devices` `manage_env` `clean_project`
Observability	`analyze_crash` `inspect_logs` `inspect_app_state` `deep_link_navigate`

Example Usage

Build and Launch

You: Build my Android app and launch it on the emulator Claude: I'll build and launch your app. [Uses build_app, install_app, launch_app]

Debug a Crash

You: My iOS app is crashing. What's wrong? Claude: Let me analyze the crash logs. [Uses analyze_crash, inspect_logs]

UI Automation

You: Take a screenshot and tap the login button Claude: I'll capture the UI and perform the tap. [Uses get_ui_context, interact_with_ui]

Requirements

Node.js 20+
Android SDK with adb in PATH (for Android tools)
Xcode Command Line Tools (for iOS tools, macOS only)
Maestro CLI (optional, for E2E testing)

Development

# Clone and install git clone https://github.com/abd3lraouf/specter-mcp.git cd specter-mcp npm install # Build npm run build # Test npm test npm run test:coverage # Lint npm run lint npm run typecheck

Architecture

src/ ├── index.ts # MCP server entry point ├── config.ts # Environment configuration ├── models/ # Type definitions and errors ├── platforms/ # Android/iOS platform utilities │ ├── android/ # ADB, Gradle, logcat, preferences │ └── ios/ # simctl, xcodebuild, oslog, crash parsing ├── queue/ # Request queue and executor ├── routing/ # Model routing dispatcher ├── tools/ # MCP tool implementations └── utils/ # Shell execution, image processing

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Specter MCP