appium-mcp 1.1.4 → 1.1.6

package/dist/tools/session-store.js

@@ -1,5 +1,6 @@
 import { AndroidUiautomator2Driver } from 'appium-uiautomator2-driver';
 import { XCUITestDriver } from 'appium-xcuitest-driver';
+import log from '../locators/logger.js';
 let driver = null;
 let sessionId = null;
 let isDeletingSession = false; // Lock to prevent concurrent deletion
@@ -26,27 +27,27 @@ export function hasActiveSession() {
 export async function safeDeleteSession() {
     // Check if there's no session to delete
     if (!driver || !sessionId) {
-        console.log('No active session to delete.');
+        log.info('No active session to delete.');
         return false;
     }
     // Check if deletion is already in progress
     if (isDeletingSession) {
-        console.log('Session deletion already in progress, skipping...');
+        log.info('Session deletion already in progress, skipping...');
         return false;
     }
     // Set lock
     isDeletingSession = true;
     try {
-        console.log('Deleting current session');
+        log.info('Deleting current session');
         await driver.deleteSession();
         // Clear the session from store
         driver = null;
         sessionId = null;
-        console.log('Session deleted successfully.');
+        log.info('Session deleted successfully.');
         return true;
     }
     catch (error) {
-        console.error('Error deleting session:', error);
+        log.error('Error deleting session:', error);
         throw error;
     }
     finally {

package/dist/tools/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/tools/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,IAAI,MAAM,GAAQ,IAAI,CAAC;AACvB,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,IAAI,iBAAiB,GAAG,KAAK,CAAC,CAAC,sCAAsC;AAErE,MAAM,UAAU,UAAU,CAAC,CAAM,EAAE,EAAiB;IAClD,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,EAAE,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACZ,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,wCAAwC;IACxC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;IACX,iBAAiB,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE7B,+BAA+B;QAC/B,MAAM,GAAG,IAAI,CAAC;QACd,SAAS,GAAG,IAAI,CAAC;QAEjB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,sBAAsB;QACtB,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAW,EAAU,EAAE;IACrD,IAAI,MAAM,YAAY,yBAAyB;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,MAAM,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AACzC,CAAC,CAAC"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/tools/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,GAAG,MAAM,uBAAuB,CAAC;AAExC,IAAI,MAAM,GAAQ,IAAI,CAAC;AACvB,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,IAAI,iBAAiB,GAAG,KAAK,CAAC,CAAC,sCAAsC;AAErE,MAAM,UAAU,UAAU,CAAC,CAAM,EAAE,EAAiB;IAClD,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,EAAE,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACZ,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,wCAAwC;IACxC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,2CAA2C;IAC3C,IAAI,iBAAiB,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;IACX,iBAAiB,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACrC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE7B,+BAA+B;QAC/B,MAAM,GAAG,IAAI,CAAC;QACd,SAAS,GAAG,IAAI,CAAC;QAEjB,GAAG,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,sBAAsB;QACtB,iBAAiB,GAAG,KAAK,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAW,EAAU,EAAE;IACrD,IAAI,MAAM,YAAY,yBAAyB;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,MAAM,YAAY,cAAc;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-mcp",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "type": "module",
   "main": "src/index.ts",
   "bin": {

package/src/locators/generate-all-locators.ts

@@ -5,6 +5,7 @@ import { getSuggestedLocators } from './locator-generation.js';
 import { xmlToJSON, JSONElement } from './source-parsing.js';
 import { shouldIncludeElement, FilterOptions } from './element-filter.js';
 import * as fs from 'fs';
+import log from './logger.js';
 
 export interface ElementWithLocators {
   tagName: string;
@@ -69,7 +70,7 @@ function processElement(
     );
     results.push(transformElementWithLocators(element, strategyMap));
   } catch (error) {
-    console.error(
+    log.error(
       `Error generating locators for element at path ${element.path}:`,
       error
     );

package/src/resources/index.ts

@@ -1,7 +1,8 @@
 // Export all resources
 import javaTemplatesResource from './java/template.js';
+import log from '../locators/logger.js';
 
 export default function registerResources(server: any) {
   javaTemplatesResource(server);
-  console.log('All resources registered');
+  log.info('All resources registered');
 }

package/src/tools/README.md

@@ -25,6 +25,7 @@ This directory contains all MCP tools available in MCP Appium.
   - `double-tap.ts` - Double tap elements
   - `set-value.ts` - Enter text
   - `get-text.ts` - Get element text
+  - `get-page-source.ts` - Get page source (XML) from current screen
   - `screenshot.ts` - Capture screenshots
   - `activate-app.ts` - Activate apps
   - `terminate-app.ts` - Terminate apps
@@ -112,7 +113,7 @@ export default function registerTools(server: FastMCP): void {
 1. **Always check for active session**: Use `getDriver()` and check for null
 2. **Provide helpful errors**: Give clear error messages
 3. **Use proper types**: Leverage TypeScript and Zod for type safety
-4. **Add logging**: Use `console.log` for debugging
+4. **Add logging**: Use the logger from `../locators/logger.js` for debugging. Import with: `import log from '../locators/logger.js'`. Use `log.info()`, `log.error()`, `log.warn()` instead of `console.log/error/warn` to maintain JSON-RPC compatibility
 5. **Handle errors**: Always wrap risky operations in try-catch
 6. **Return proper format**: Always return content in expected MCP format
 

package/src/tools/answer-appium.ts

@@ -6,6 +6,7 @@ import {
   answerAppiumQuery,
   initializeAppiumDocumentation,
 } from './documentation/index.js';
+import log from '../locators/logger.js';
 
 export default function answerAppium(server: any): void {
   server.addTool({
@@ -45,7 +46,7 @@ export default function answerAppium(server: any): void {
       } catch (docError) {
         // If documentation query fails, try to initialize and retry once
         try {
-          console.log('Documentation not initialized, initializing now...');
+          log.info('Documentation not initialized, initializing now...');
           await initializeAppiumDocumentation();
           const result = await answerAppiumQuery({ query });
           return {

package/src/tools/boot-simulator.ts

@@ -4,6 +4,7 @@
 import { z } from 'zod';
 import { Simctl } from 'node-simctl';
 import { IOSManager } from '../devicemanager/ios-manager.js';
+import log from '../locators/logger.js';
 
 export default function bootSimulator(server: any): void {
   server.addTool({
@@ -79,7 +80,7 @@ export default function bootSimulator(server: any): void {
           ],
         };
       } catch (error: any) {
-        console.error('Error booting simulator:', error);
+        log.error('Error booting simulator:', error);
         throw new Error(`Failed to boot simulator: ${error.message}`);
       }
     },

package/src/tools/delete-session.ts

@@ -3,6 +3,7 @@
  */
 import { z } from 'zod';
 import { safeDeleteSession } from './session-store.js';
+import log from '../locators/logger.js';
 
 export default function deleteSession(server: any): void {
   server.addTool({
@@ -38,7 +39,7 @@ export default function deleteSession(server: any): void {
           };
         }
       } catch (error: any) {
-        console.error(`Error deleting session`, error);
+        log.error(`Error deleting session`, error);
         throw new Error(`Failed to delete session: ${error.message}`);
       }
     },

package/src/tools/documentation/index.ts

@@ -10,6 +10,7 @@ import {
   indexAllMarkdownFiles,
 } from './simple-pdf-indexer.js';
 import * as path from 'path';
+import log from '../../locators/logger.js';
 
 /**
  * Interface for the query response
@@ -31,11 +32,11 @@ export async function initializeAppiumDocumentation(
     // Default to submodules directory if not specified
     const docsPath =
       resourcesPath || path.resolve(__dirname, '../../resources/submodules');
-    console.log(`Initializing Appium documentation from: ${docsPath}`);
+    log.info(`Initializing Appium documentation from: ${docsPath}`);
     await indexAllMarkdownFiles(docsPath);
-    console.log('Appium documentation indexing completed');
+    log.info('Appium documentation indexing completed');
   } catch (error) {
-    console.error('Error initializing Appium documentation:', error);
+    log.error('Error initializing Appium documentation:', error);
     throw error;
   }
 }
@@ -50,7 +51,7 @@ export async function answerAppiumQuery(options: {
 }): Promise<QueryResponse> {
   try {
     const { query } = options;
-    console.log(`Querying vector store for: "${query}"`);
+    log.info(`Querying vector store for: "${query}"`);
     const results = await queryVectorStore(query); // Get relevant chunks
 
     if (!results || results.length === 0) {
@@ -75,7 +76,7 @@ export async function answerAppiumQuery(options: {
           source && arr.indexOf(source) === index
       ); // Remove duplicates
 
-    console.log(
+    log.info(
       `Found ${results.length} relevant chunks from ${sources.length} sources`
     );
 
@@ -91,7 +92,7 @@ export async function answerAppiumQuery(options: {
       chunks,
     };
   } catch (error) {
-    console.error('Error querying Appium documentation:', error);
+    log.error('Error querying Appium documentation:', error);
     throw error;
   }
 }

package/src/tools/documentation/reasoning-rag.ts

@@ -8,6 +8,7 @@
 
 import { Document } from 'langchain/document';
 import { queryVectorStore } from './simple-pdf-indexer.js';
+import log from '../../locators/logger.js';
 
 /**
  * Reasoning task types supported by the system
@@ -77,9 +78,9 @@ export class ReasoningRAG {
       );
       this.transformers = await importTransformers();
       this.isInitialized = true;
-      console.log('Xenova transformers initialized for reasoning');
+      log.info('Xenova transformers initialized for reasoning');
     } catch (error) {
-      console.error('Error importing @xenova/transformers:', error);
+      log.error('Error importing @xenova/transformers:', error);
       throw new Error(
         `Failed to import @xenova/transformers: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -98,7 +99,7 @@ export class ReasoningRAG {
 
     await this.initializeTransformers();
 
-    console.log(`Loading model for ${config.task}: ${config.modelName}`);
+    log.info(`Loading model for ${config.task}: ${config.modelName}`);
 
     try {
       const model = await this.transformers.pipeline(
@@ -106,10 +107,10 @@ export class ReasoningRAG {
         config.modelName
       );
       this.models.set(modelKey, model);
-      console.log(`Successfully loaded model: ${config.modelName}`);
+      log.info(`Successfully loaded model: ${config.modelName}`);
       return model;
     } catch (error) {
-      console.error(`Error loading model ${config.modelName}:`, error);
+      log.error(`Error loading model ${config.modelName}:`, error);
       throw new Error(
         `Failed to load model: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -190,7 +191,7 @@ export class ReasoningRAG {
         },
       };
     } catch (error) {
-      console.error(`Error performing reasoning with ${config.task}:`, error);
+      log.error(`Error performing reasoning with ${config.task}:`, error);
       return {
         originalChunk: text,
         reasoningOutput: `Error during reasoning: ${error instanceof Error ? error.message : String(error)}`,
@@ -230,7 +231,7 @@ export class ReasoningRAG {
 
       // Log progress for large batches
       if (chunks.length > batchSize) {
-        console.log(
+        log.info(
           `Processed reasoning for ${Math.min(i + batchSize, chunks.length)}/${chunks.length} chunks`
         );
       }
@@ -295,10 +296,10 @@ export class ReasoningRAG {
     } = options;
 
     try {
-      console.log(`Starting reasoning-enhanced RAG query: "${query}"`);
+      log.info(`Starting reasoning-enhanced RAG query: "${query}"`);
 
       // Step 1: Retrieve relevant chunks using existing RAG
-      console.log(`Retrieving top ${topK} relevant chunks...`);
+      log.info(`Retrieving top ${topK} relevant chunks...`);
       const retrievedChunks = await queryVectorStore(query, topK);
 
       if (!retrievedChunks || retrievedChunks.length === 0) {
@@ -312,7 +313,7 @@ export class ReasoningRAG {
         };
       }
 
-      console.log(`Retrieved ${retrievedChunks.length} chunks for reasoning`);
+      log.info(`Retrieved ${retrievedChunks.length} chunks for reasoning`);
 
       // Step 2: Configure reasoning models
       const configs: ReasoningConfig[] = customConfigs || [
@@ -336,7 +337,7 @@ export class ReasoningRAG {
       );
 
       // Step 3: Perform reasoning on retrieved chunks
-      console.log(
+      log.info(
         `Performing reasoning with ${filteredConfigs.length} different models...`
       );
       const reasoningResults = await this.processChunksWithReasoning(
@@ -346,7 +347,7 @@ export class ReasoningRAG {
       );
 
       // Step 4: Generate comprehensive summary
-      console.log('Generating comprehensive summary...');
+      log.info('Generating comprehensive summary...');
       const summary = await this.generateComprehensiveSummary(
         reasoningResults,
         query
@@ -379,7 +380,7 @@ export class ReasoningRAG {
             source && arr.indexOf(source) === index
         );
 
-      console.log(
+      log.info(
         `Reasoning-enhanced RAG completed. Generated ${reasoningResults.length} reasoning results from ${sources.length} sources`
       );
 
@@ -392,7 +393,7 @@ export class ReasoningRAG {
         sources,
       };
     } catch (error) {
-      console.error('Error in reasoning-enhanced RAG:', error);
+      log.error('Error in reasoning-enhanced RAG:', error);
       throw new Error(
         `Reasoning-enhanced RAG failed: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -426,7 +427,7 @@ export class ReasoningRAG {
    */
   async cleanup(): Promise<void> {
     this.models.clear();
-    console.log('Reasoning RAG resources cleaned up');
+    log.info('Reasoning RAG resources cleaned up');
   }
 }
 

package/src/tools/documentation/sentence-transformers-embeddings.ts

@@ -5,6 +5,8 @@
  * This is perfect for self-hosted MCP servers and eliminates external dependencies.
  */
 
+import log from '../../locators/logger.js';
+
 /**
  * LangChain-compatible embeddings class using sentence-transformers
  */
@@ -34,7 +36,7 @@ export class SentenceTransformersEmbeddings {
       );
       this.transformers = await importTransformers();
     } catch (error) {
-      console.error('Error importing @xenova/transformers:', error);
+      log.error('Error importing @xenova/transformers:', error);
       throw new Error(
         `Failed to import @xenova/transformers: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -51,18 +53,18 @@ export class SentenceTransformersEmbeddings {
 
     await this.initializeTransformers();
 
-    console.log(`Initializing sentence-transformers model: ${this.modelName}`);
+    log.info(`Initializing sentence-transformers model: ${this.modelName}`);
     try {
       this.model = await this.transformers.pipeline(
         'feature-extraction',
         this.modelName
       );
       this.isInitialized = true;
-      console.log(
+      log.info(
         `Successfully initialized sentence-transformers model: ${this.modelName}`
       );
     } catch (error) {
-      console.error('Error initializing sentence-transformers model:', error);
+      log.error('Error initializing sentence-transformers model:', error);
       throw new Error(
         `Failed to initialize sentence-transformers model: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -89,7 +91,7 @@ export class SentenceTransformersEmbeddings {
       const embeddings = Array.from(result.data) as number[];
       return embeddings;
     } catch (error) {
-      console.error('Error generating embeddings:', error);
+      log.error('Error generating embeddings:', error);
       throw new Error(
         `Failed to generate embeddings: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -125,7 +127,7 @@ export class SentenceTransformersEmbeddings {
 
         // Log progress for large batches
         if (texts.length > batchSize) {
-          console.log(
+          log.info(
             `Processed ${Math.min(i + batchSize, texts.length)}/${texts.length} documents`
           );
         }
@@ -133,7 +135,7 @@ export class SentenceTransformersEmbeddings {
 
       return embeddings;
     } catch (error) {
-      console.error('Error generating document embeddings:', error);
+      log.error('Error generating document embeddings:', error);
       throw new Error(
         `Failed to generate document embeddings: ${error instanceof Error ? error.message : String(error)}`
       );