@nbakka/mcp-appium 4.0.2 → 4.0.4

package/lib/server.js

@@ -171,6 +171,48 @@ tool(
   }
 );
 
+tool(
+  "guidelines_to_write_code",
+  "Read coding guidelienes from ~/guardian/.cursor/rules/mcp-production-grade.json and return them so they can be followed when writing code. These guidelines include coding standards, best practices, patterns to follow, and anti-patterns to avoid. They are mandatory to follow when writing code. NOTE: Only write code after app exploration is complete and locators are fetched.",
+  {},
+  async () => {
+    try {
+      // Construct path: ~/guardian/.cursor/rules/mcp-production-grade.json
+      const guidelinesPath = path.join(os.homedir(), 'guardian', '.cursor', 'rules', 'mcp-production-grade.json');
+      
+      // Read the JSON file
+      const guidelinesContent = await fs.readFile(guidelinesPath, "utf-8");
+      
+      // Parse and validate JSON
+      const guidelines = JSON.parse(guidelinesContent);
+      
+      // Return the guidelines content for the LLM to read and follow
+      return `📋 PRODUCTION-GRADE CODING GUIDELINES
+
+IMPORTANT: You MUST follow these guidelines when writing ANY code:
+
+${JSON.stringify(guidelines, null, 2)}
+
+Instructions:
+1. Read and understand ALL guidelines above thoroughly
+2. Apply these guidelines to EVERY piece of code you write
+3. Follow the specified patterns, naming conventions, and best practices
+4. Prioritize code quality, maintainability, and consistency with these guidelines
+
+These are mandatory requirements - not suggestions.`;
+      
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        return `❌ Error: Guidelines file not found at ~/guardian/.cursor/rules/mcp-production-grade.json\n\nPlease ensure the file exists at this location in your home directory.`;
+      }
+      if (error instanceof SyntaxError) {
+        return `❌ Error: Invalid JSON in guidelines file. Please check the file format.`;
+      }
+      return `❌ Error reading coding guidelines: ${error.message}`;
+    }
+  }
+);
+
  tool("mobile_list_elements_on_screen", "List elements on screen in a simplified, flattened structure. Returns only useful attributes: text, class, id (resource-id), accessibilityId (content-desc), and bounds. Do not cache this result.", {}, async ({}) => {
      requireRobot();
      const elements = await robot.getSimplifiedElements();
@@ -185,7 +227,7 @@ tool(
         return `Pressed the button: ${button}`;
     });
 
-    tool("mobile_open_url", "Open a URL in browser on device", {
+    tool("mobile_open_deeplink", "Open a deeplink in app on device", {
         url: zod_1.z.string().describe("The URL to open"),
     }, async ({ url }) => {
         requireRobot();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbakka/mcp-appium",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "Appium MCP",
   "engines": {
     "node": ">=18"