android-mcp-toolkit 1.1.0 → 1.2.0

package/README.md

@@ -1,8 +1,9 @@
 # Android MCP Toolkit for AI Agents
 
-Small MCP server with two tools:
+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**
@@ -72,6 +73,10 @@ While the AI ecosystem flourishes with web-first tools, Android development ofte
   - Inputs: `timeoutMs` (default `5000`, max `15000`).
   - Behavior: Runs `adb logcat -c` to clear buffers before a new scenario.
 
+- `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.
@@ -83,15 +88,11 @@ While the AI ecosystem flourishes with web-first tools, Android development ofte
 
 ## Quick start
 - `npm install`
-- `npm start` (keeps running on stdio; point your MCP client at `node src/index.js`)
+- `npm run build`
+- `node dist/index.js` (stdio MCP server)
 
 ## Run via npx
-- From repo root: `npx .` (uses `svg-to-drawable-mcp` bin; runs on stdio)
-
-## Run with Docker
-- Build: `docker build -t svg-to-drawable-mcp .`
-- Run: `docker run --rm -it svg-to-drawable-mcp`
-- The container prints to stdio; point your MCP client at `docker run --rm -i svg-to-drawable-mcp`.
+- Global: `npx android-mcp-toolkit`
 
 ## Use in Cursor (MCP config)
 Add to your Cursor settings JSON:
@@ -101,17 +102,20 @@ Add to your Cursor settings JSON:
     "figma-desktop": {
       "url": "http://127.0.0.1:3845/mcp"
     },
-    "svg-to-android-drawable": {
+    "android-mcp-toolkit": {
       "command": "npx",
       "args": [
         "-y",
-        "/Users/admin/code/android_util_mcp_server"
+        "android-mcp-toolkit"
       ]
     }
   }
 }
 ```
-Adjust the local path if your repo lives elsewhere.
+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`

package/dist/index.js

@@ -1460,16 +1460,68 @@ var require_logcatTool = __commonJS({
   }
 });
 
+// src/tools/textLengthTool.js
+var require_textLengthTool = __commonJS({
+  "src/tools/textLengthTool.js"(exports2, module2) {
+    var z = require("zod/v4");
+    var textLengthToolInstructions2 = [
+      "Use estimate-text-length-difference to compare original vs translated text lengths and flag large deltas.",
+      "Configure tolerancePercent to set the allowed absolute percentage difference (default 30%).",
+      "The tool reports both lengths, percent change, and whether the change exceeds tolerance."
+    ].join("\n");
+    var lengthDiffInputSchema = z.object({
+      sourceText: z.string().min(1).describe("Original text before translation"),
+      translatedText: z.string().min(1).describe("Translated text to compare against the original"),
+      tolerancePercent: z.number().min(1).max(500).default(30).describe("Allowed absolute percent difference between lengths before flagging risk")
+    });
+    function measureLength(text) {
+      return Array.from(text).length;
+    }
+    function registerTextLengthTool2(server2) {
+      server2.registerTool(
+        "estimate-text-length-difference",
+        {
+          title: "Estimate text length difference",
+          description: "Compare original and translated text lengths to detect layout risk; configurable tolerancePercent (default 30%).",
+          inputSchema: lengthDiffInputSchema
+        },
+        async (params) => {
+          const sourceLength = measureLength(params.sourceText);
+          const translatedLength = measureLength(params.translatedText);
+          const delta = translatedLength - sourceLength;
+          const percentChange = sourceLength === 0 ? null : delta / sourceLength * 100;
+          const exceeds = percentChange === null ? translatedLength > 0 : Math.abs(percentChange) > params.tolerancePercent;
+          const direction = delta === 0 ? "no change" : delta > 0 ? "longer" : "shorter";
+          const verdict = percentChange === null && translatedLength === 0 ? "\u2705 Both texts are empty; no length risk." : percentChange === null ? "\u26A0\uFE0F Source length is 0; percent change undefined and translated text is present." : exceeds ? "\u26A0\uFE0F Length difference exceeds tolerance (layout risk likely)." : "\u2705 Length difference within tolerance.";
+          const summary = [
+            verdict,
+            `Source length: ${sourceLength}`,
+            `Translated length: ${translatedLength}`,
+            percentChange === null ? `Change: N/A (source length is 0; direction: ${direction})` : `Change: ${percentChange.toFixed(2)}% (${direction})`,
+            `Tolerance: \xB1${params.tolerancePercent}%`
+          ].join("\n");
+          return { content: [{ type: "text", text: summary }] };
+        }
+      );
+    }
+    module2.exports = {
+      registerTextLengthTool: registerTextLengthTool2,
+      textLengthToolInstructions: textLengthToolInstructions2
+    };
+  }
+});
+
 // src/index.js
 var { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
 var { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
 var { registerSvgTool, svgToolInstructions } = require_svgTool();
 var { registerLogcatTool, logcatToolInstructions } = require_logcatTool();
-var serverInstructions = [svgToolInstructions, logcatToolInstructions].join("\n");
+var { registerTextLengthTool, textLengthToolInstructions } = require_textLengthTool();
+var serverInstructions = [svgToolInstructions, logcatToolInstructions, textLengthToolInstructions].join("\n");
 var server = new McpServer(
   {
     name: "svg-to-android-drawable",
-    version: "1.1.0"
+    version: "1.2.0"
   },
   {
     capabilities: { logging: {} },
@@ -1478,6 +1530,7 @@ var server = new McpServer(
 );
 registerSvgTool(server);
 registerLogcatTool(server);
+registerTextLengthTool(server);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android-mcp-toolkit",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server that converts SVG into Android VectorDrawable XML with a fast path and caching.",
   "main": "dist/index.js",
   "scripts": {