Skip to main content
Glama
android-mcp-toolkit

android-mcp-toolkit

by Nam0101

Android MCP Toolkit for AI Agents

Small MCP server with three tools:

  • Fast SVG → Android VectorDrawable conversion (cached, file or inline).

  • adb logcat reader with package/pid/tag filters for quick crash triage.

  • Translation length difference estimator to flag risky length deltas before layout breaks.

Why this exists

The Mission: Bringing Native Android to the AI Agent Era

While the AI ecosystem flourishes with web-first tools, Android development often feels left behind. This MCP server is my answer to that gap—a dedicated bridge connecting AI Agents directly to the Android toolchain.

⚡ Zero-Friction Asset Conversion: Convert SVGs to VectorDrawables instantly without the overhead of launching Android Studio.

🔍 Direct Diagnostic Access: Empower agents to pull, filter, and analyze adb logcat streams (by package, PID, or tag) in real-time.

🤖 Agent-Native Architecture: Deliver structured, scriptable outputs that LLMs can parse and act upon efficiently.

🚀 Built for Extensibility: A solid foundation designed to grow, paving the way for future utilities like bitmap helpers and asset validation.

Related MCP server: Local Figma MCP Bridge

Pairing ideas

  • Figma MCP: grab SVGs from designs, feed to convert-svg-to-android-drawable to get XML for Android resources.

  • Debugging: while running the app, call read-adb-logcat with package name or tag to capture crashes and filtered logs without leaving the MCP client.

Previews

SVG to VectorDrawable

  • Figma request → SVG extraction
    Figma request via MCP

  • Flag conversion preview (single)
    Flag conversion preview

  • Batch flag review (side-by-side)
    Batch flag review

  • Batch run via MCP (console)
    Batch run via MCP

ADB logcat tool

  • Crash capture prompt (inputs + filters)
    Crash logcat prompt

  • Response preview (summarized logcat)
    Response gap prompt

Current tools

  • convert-svg-to-android-drawable

    • Inputs: svg (inline) or svgPath (file path). Optional: outputPath, floatPrecision (default 2), fillBlack (default false), xmlTag (default false), tint, cache (default true).

    • Output: VectorDrawable XML text; also writes to disk when outputPath is provided.

    • Performance: LRU cache (32 entries) keyed by SVG + options plus fast reuse in-session.

    • Converter: vendored fork in vendor/svg2vectordrawable with fixes for rgb()/rgba(), hsl()/hsla(), and named colors. Upstream license: vendor/svg2vectordrawable/LICENSE (MIT).

  • manage-logcat

    • Inputs:

      • action: read (default), crash, anr, or clear.

      • packageName: Optional. Resolves PID via adb shell pidof.

      • pid: Optional. Explicit PID.

      • tag: Optional. Filter by tag (e.g. MyApp).

      • priority: V, D, I, W, E, F, S (default V).

      • maxLines: Tail count (default 200, max 2000).

      • timeoutMs: Default 5000.

    • Behavior:

      • read: Fetches logcat tail.

      • crash: Fetches logcat -b crash.

      • anr: Fetches recent ActivityManager ANR logs + tail of /data/anr/traces.txt.

      • clear: clears logcat buffers.

  • get-current-activity

    • Inputs: timeoutMs (default 5000, max 15000).

    • Behavior: Inspects dumpsys window to find the currently focused app/window. Useful to verify state.

  • dump-ui-hierarchy

    • Inputs: timeoutMs (default 10000).

    • Behavior: Captures current UI hierarchy as XML via uiautomator.

  • take-screenshot

    • Inputs: outputPath (required), timeoutMs.

    • Behavior: Saves device screenshot to local file.

  • inject-input

    • Inputs: command (tap, text, swipe, keyevent, back, home), args (array), timeoutMs.

    • Optional: elementId or elementText (finds element center and taps it).

    • Behavior: Simulates user interaction suitable for testing flows.

  • estimate-text-length-difference

    • Inputs: sourceText (original), translatedText (to compare), tolerancePercent (default 30, max 500).

    • Behavior: Measures grapheme length of both strings, computes percent change, and reports whether it exceeds the tolerance (useful to catch translation length blowups that could break layouts).

Roadmap (planned)

  • Additional MCP tools for Android assets (e.g., batch conversions, validations, optimizers).

  • Optional resource prompts for common Android drawables/templates.

Quick start

  • npm install

  • npm run build

  • node dist/index.js (stdio MCP server)

Run via npx

  • Global: npx android-mcp-toolkit

Use in Cursor (MCP config)

Add to your Cursor settings JSON:

{
  "mcpServers": {
    "android-mcp-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "android-mcp-toolkit"
      ]
    }
  }
}

The npx call downloads the published package; no local path required.

Quick install via Cursor deep link:

  • cursor://anysphere.cursor-deeplink/mcp/install?name=android-mcp-toolkit&config=eyJjb21tYW5kIjoibnB4IC15IGFuZHJvaWQtbWNwLXRvb2xraXQifQ%3D%3D

Examples

  • Input SVG: sample_svg.svg

  • Output VectorDrawable: examples/sample_svg.xml

Notes

  • Transport: stdio via @modelcontextprotocol/sdk.

  • Base deps kept minimal; everything needed to convert SVGs is vendored/included.

Contact

Available Tools

7 tools
convert-svg-to-android-drawableSVG to VectorDrawableA

Convert SVG markup or files into Android VectorDrawable XML quickly, optionally writing to disk.

Inputs: svg, svgPath, outputPath, floatPrecision, +4 more.

dump-ui-hierarchyDump UI Hierarchy (XML)B

Capture the current UI hierarchy as XML using uiautomator.

Inputs: timeoutMs.

estimate-text-length-differenceEstimate text length differenceA

Compare original and translated text lengths to detect layout risk; configurable tolerancePercent (default 30%).

Inputs: sourceText (required), translatedText (required), tolerancePercent.

get-current-activityGet current activity/window focusB

Inspect current focused app/window via dumpsys window.

Inputs: timeoutMs.

inject-inputInject Input EventsB

Simulate user input interactions (tap, text, swipe, keyevents) or click by UI element.

Inputs: command (required), args, elementId, elementText, +1 more.

manage-logcatManage ADB LogcatA

Unified tool to read logs, capture crashes, check ANRs, and clear buffers.

Inputs: action, packageName, pid, tag, +3 more.

take-screenshotTake User ScreenshotB

Capture device screenshot and save to a local file.

Inputs: outputPath (required), timeoutMs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of Android device interaction: drawing conversion, UI hierarchy, text estimation, activity info, input simulation, logcat management, and screenshot capture. No two tools overlap in purpose.

    Naming Consistency4/5

    Most tools follow a verb-noun pattern (e.g., dump-ui-hierarchy, inject-input), but 'convert-svg-to-android-drawable' breaks this pattern with a longer descriptive phrase. Overall, the naming is still readable and predictable.

    Tool Count5/5

    Seven tools cover the essential aspects of Android device testing and automation without being overwhelming. The count is well-scoped for the toolkit's purpose.

    Completeness3/5

    The toolkit covers core UI testing operations (hierarchy, input, screenshot, logcat) but lacks tools for app management, clipboard access, or device configuration. The inclusion of SVG conversion and text length estimation adds niche functionality, but common tasks like UI element querying (beyond typing coordinates) are missing.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for converting SVG files to Android Vector Drawable XML, enabling seamless integration with Figma MCP for Android development.
      1
      9 npm
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Unofficial local MCP bridge for reading the currently open Figma file through a Figma plugin. Provides tools to inspect selection, file info, and export selected nodes as SVG/PNG.
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      MCP server that provides AI coding agents real Android development tools—Gradle, adb, logcat, lint, crash triage—through a local, permissioned interface. Enables agents to inspect projects, run safe Gradle tasks, capture logs/screenshots, and triage crashes.
      1
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides AI agents with a unified MCP interface for Android APK reverse engineering, metadata analysis, Smali/resource editing, rebuilding, signing, verification, and ADB device testing.
      MIT