Android MCP Toolkit

🚀 Android MCP Toolkit for AI Agents

This is a small MCP server equipped with three tools:

• Fast conversion from SVG to Android VectorDrawable (cached, can be file or inline).
• An adb logcat reader with package/pid/tag filters for rapid crash triage.
• A translation length difference estimator to identify risky length deltas before layout breaks.

🚀 Quick Start

• npm install
• npm run build
• node dist/index.js (stdio MCP server)

✨ Features

The Mission: Bringing Native Android to the AI Agent Era

While the AI ecosystem thrives with web - first tools, Android development often lags behind. This MCP server is the solution to this gap, serving as a dedicated bridge that directly connects AI Agents to the Android toolchain.

• ⚡ Zero - Friction Asset Conversion: Instantly convert SVGs to VectorDrawables without the need to launch Android Studio.
• 🔍 Direct Diagnostic Access: Enable agents to pull, filter, and analyze adb logcat streams (by package, PID, or tag) in real - time.
• 🤖 Agent - Native Architecture: Provide structured, scriptable outputs that LLMs can efficiently parse and act upon.
• 🚀 Built for Extensibility: A robust foundation designed for growth, paving the way for future utilities such as bitmap helpers and asset validation.

Pairing Ideas

• Figma MCP: Retrieve SVGs from designs and feed them to convert - svg - to - android - drawable to obtain XML for Android resources.
• Debugging: While the app is running, call read - adb - logcat with the 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)
  

📦 Installation

Run via npx

• Global: npx android - mcp - toolkit

Use in Cursor (MCP config)

Add the following 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 is required.

Quick install via Cursor deep link:

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

💻 Usage Examples

Input and Output Example

• Input SVG: sample_svg.svg
• Output VectorDrawable: examples/sample_svg.xml

📚 Documentation

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.

🔧 Technical Details

• Transport: stdio via @modelcontextprotocol/sdk.
• Base deps kept minimal; everything needed to convert SVGs is vendored/included.

📄 Notes

Contact

• nam.nv205106@gmail.com