Android MCP Toolkit

Provides Android-focused MCP tools for SVG conversion, adb logcat access, and translation length checks.

javascript

6

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

The Android MCP Toolkit lets you connect AI agents to a compact Android-focused toolchain. It provides fast SVG to VectorDrawable conversion, an adb logcat reader with filtering, and a translation length difference estimator to catch layout risks, all exposed as MCP endpoints you can script and automate.

How to use

You interact with the Android MCP Toolkit through an MCP client. Start the local MCP server (stdio) or run it via npx, then add it as a server in your MCP workflow. Use the available tools to convert SVGs, inspect crash logs, or estimate text length differences to prevent layout issues.

How to install

Prerequisites you need before starting:

Node.js and npm installed on your machine
A working MCP client to connect to stdio or to run npx commands
Internet access for initial package installation

Install the package dependencies and build the server, then start the stdio server or use the npx shortcut.

Step 1: Install dependencies and build the project.

npm install
npm run build

Step 2: Run the server via stdio (local server). Use the complete command to start the server.

node dist/index.js

Step 3: Alternatively, run the server through npx for a quick start without local installation.

npx android-mcp-toolkit

Notes

The toolkit includes several dedicated tools for common Android-focused tasks. Each tool has clearly defined inputs and outputs, and many options support in-session caching and selective filtering to keep interactions efficient.

If you plan to use the tools in scripts, reference the tool names directly in your MCP prompts and parse the structured outputs for reliable automation.

Run via npx

You can start the toolkit without a local install by invoking it with npx, which downloads and runs the package on demand.

npx android-mcp-toolkit

Example workflows

SVG to VectorDrawable conversion: provide an SVG input, run the conversion tool, and capture the resulting VectorDrawable XML for use in Android resources.

Crash triage: use the adb logcat reader with package name or tag to filter and retrieve relevant crash logs for analysis.

Available tools

convert-svg-to-android-drawable

Converts SVG input to VectorDrawable XML text. Accepts inline SVG or a file path, with options for output path, numeric precision, fill behavior, tint, and caching.

read-adb-logcat

Fetches and filters adb logcat output by package, pid, or tag with configurable priority and line limits.

get-pid-by-package

Resolves a process ID for a given Android package name to enable precise log filtering.

get-current-activity

Parses device state to identify the currently focused activity or window for quick context.

fetch-crash-stacktrace

Retrieves crash stack traces from the device crash buffer, optionally filtering by package pid.

check-anr-state

Gathers ANR-related logs and traces to help diagnose runtime responsiveness issues.

clear-logcat-buffer

Clears the logcat buffers to prepare for a clean run or test scenario.

estimate-text-length-difference

Measures grapheme lengths of original and translated texts, compares change percentage, and flags potential layout risks.