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.

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
Flag conversion preview (single)
Batch flag review (side-by-side)
Batch run via MCP (console)

ADB logcat tool

Crash capture prompt (inputs + filters)
Response preview (summarized logcat)

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

nam.nv205106@gmail.com