mobile-debug-mcp 0.28.0 → 0.29.0

package/dist/server-core.js

@@ -1,19 +1,29 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { wrapResponse } from './server/common.js';
 import { toolDefinitions } from './server/tool-definitions.js';
 import { handleToolCall } from './server/tool-handlers.js';
 export { wrapResponse, toolDefinitions, handleToolCall };
 export const serverInfo = {
     name: 'mobile-debug-mcp',
-    version: '0.28.0'
+    version: '0.29.0'
 };
 export function createServer() {
     const server = new Server(serverInfo, {
         capabilities: {
+            resources: {},
             tools: {}
         }
     });
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: []
+    }));
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+        resourceTemplates: []
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async () => ({
+        contents: []
+    }));
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: toolDefinitions
     }));

package/dist/server.js

@@ -3,9 +3,11 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { createServer } from './server-core.js';
 import { getSystemStatus } from './system/index.js';
 const server = createServer();
-getSystemStatus().then((res) => {
-    console.debug('[startup] system status summary:', { adb: res.adbAvailable, ios: res.iosAvailable, devices: res.devices, iosDevices: res.iosDevices });
-}).catch((e) => console.warn('[startup] healthcheck failed:', e instanceof Error ? e.message : String(e)));
+if (process.env.MOBILE_DEBUG_MCP_STARTUP_HEALTHCHECK === '1') {
+    getSystemStatus().then((res) => {
+        console.info('[startup] system status summary:', { adb: res.adbAvailable, ios: res.iosAvailable, devices: res.devices, iosDevices: res.iosDevices });
+    }).catch((e) => console.warn('[startup] healthcheck failed:', e instanceof Error ? e.message : String(e)));
+}
 const transport = new StdioServerTransport();
 async function main() {
     await server.connect(transport);

package/docs/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to the **Mobile Debug MCP** project will be documented in this file.
 
+## [0.29.0]
+- Added empty resource handlers and declared the `resources` capability so Codex MCP discovery can complete the handshake against the published npm package.
+- Moved the startup healthcheck behind an opt-in flag to keep the stdio protocol channel quiet by default.
+
 ## [0.28.0]
 - Added structured execution trace model for all actions within the MCP runtime. It provides visibility into resolution, execution, verification, stabilization, and recovery stages.
 

package/docs/ROADMAP.md

@@ -45,25 +45,22 @@ Higher task success with fewer retries.
 - Stronger State Verification — Complete (Foundational verification layer shipped)
 - Richer Element Identity — Complete (Identity and selector confidence foundations shipped)
 - Better Compose / Custom Control Semantics — Complete (Semantic role enrichment and custom-adjustable inference shipped)
+- Verification Stabilization and Temporal Convergence — Complete (Temporal verification and convergence logic shipped)
+- Action Trace and Execution Observability — Complete (Structured execution trace model shipped)
 
 ## Current Focus
 
-- Wait and Synchronization Reliability
+- Wait and Synchronization Reliability (implementation + tuning)
 - Actionability Resolution
-- Verification Stabilization and Temporal Convergence
+- Adjustable Control Precision Hardening
 
 ## Upcoming Work
 
 - Adjustable Control Precision Hardening
 - Environment Auto-Configuration and Toolchain Discovery
 - Adjustable Control Support
-- Verification Stabilization and Temporal Convergence
 - Signal-Oriented Diagnostic Filtering
 - Long Press Gesture
-# Stronger State Verification
-# Richer Element Identity
-# Wait and Synchronization Reliability
-# Environment Auto-Configuration and Toolchain Discovery
 
 ## Rationale
 Reduce onboarding friction and improve developer experience by minimizing manual setup dependencies.
@@ -115,7 +112,7 @@ Strengthens:
 ## Later Horizon
 
 - Pinch to Zoom
-- Action Trace Correlation
+- Advanced Trace Correlation and Analysis
 
 ---
 
@@ -251,7 +248,7 @@ Blocks or strengthens:
 ## Rationale
 Real-world feedback exposed false-negative readiness failures caused by transient UI timing, even when target state had actually converged.
 
-**Status:** Planned
+**Status:** Completed
 
 Addresses friction where agents:
 - fail readiness checks on transient timing races
@@ -615,12 +612,14 @@ Depends on:
 
 ---
 
-# Action Trace Correlation
+# Advanced Trace Correlation
 
 ## Rationale
 Very valuable for debugging,
 but less critical than improving control success first.
 
+Builds on the foundational Action Trace and Execution Observability capability by linking traces across UI, network, and logs.
+
 **Status:** Planned
 
 Improves diagnosis more than task completion.
@@ -695,7 +694,6 @@ Make core loop reliable and reduce onboarding friction.
 - Adjustable Control Precision Hardening
 - Better Compose / Custom Control Semantics
 - Signal-Oriented Diagnostic Filtering
-- Verification Stabilization and Temporal Convergence
 
 Focus:
 Improve control precision, verification convergence, custom control reliability, and signal observability.
@@ -712,7 +710,7 @@ Expand interaction capability after core control reliability is improved.
 
 ## Wave 4 (Advanced Gestures + Deep Observability)
 - Pinch to Zoom
-- Action Trace Correlation
+- Advanced Trace Correlation and Analysis
 
 Focus:
 Advanced gestures + deep observability.
@@ -725,16 +723,15 @@ Roadmap Ordering:
 1. Stronger State Verification
 2. Richer Element Identity
 3. Wait and Synchronization Reliability
-4. Verification Stabilization and Temporal Convergence
-5. Environment Auto-Configuration and Toolchain Discovery
-6. Actionability Resolution
-7. Adjustable Control Support
-8. Adjustable Control Precision Hardening
-9. Better Compose / Custom Control Semantics
-10. Signal-Oriented Diagnostic Filtering
-11. Long Press Gesture
-12. Pinch to Zoom
-13. Action Trace Correlation
+4. Actionability Resolution
+5. Adjustable Control Support
+6. Adjustable Control Precision Hardening
+7. Environment Auto-Configuration and Toolchain Discovery
+8. Better Compose / Custom Control Semantics
+9. Signal-Oriented Diagnostic Filtering
+10. Long Press Gesture
+11. Pinch to Zoom
+12. Advanced Trace Correlation and Analysis
 
 Rationale:
 - Early roadmap items harden state, targeting, synchronization, environment readiness, and action execution.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mobile-debug-mcp",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "MCP server for mobile app debugging (Android + iOS), with focus on security and reliability",
   "type": "module",
   "bin": {

package/src/server-core.ts

@@ -1,6 +1,9 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import type { SchemaOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js'
 import {
+  ListResourcesRequestSchema,
+  ListResourceTemplatesRequestSchema,
+  ReadResourceRequestSchema,
   ListToolsRequestSchema,
   CallToolRequestSchema
 } from '@modelcontextprotocol/sdk/types.js'
@@ -13,7 +16,7 @@ export { wrapResponse, toolDefinitions, handleToolCall }
 
 export const serverInfo = {
   name: 'mobile-debug-mcp',
-  version: '0.28.0'
+  version: '0.29.0'
 }
 
 export function createServer() {
@@ -21,11 +24,24 @@ export function createServer() {
     serverInfo,
     {
       capabilities: {
+        resources: {},
         tools: {}
       }
     }
   )
 
+  server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: []
+  }))
+
+  server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+    resourceTemplates: []
+  }))
+
+  server.setRequestHandler(ReadResourceRequestSchema, async () => ({
+    contents: []
+  }))
+
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: toolDefinitions
   }))

package/src/server.ts

@@ -5,9 +5,11 @@ import { getSystemStatus } from './system/index.js'
 
 const server = createServer()
 
-getSystemStatus().then((res) => {
-  console.debug('[startup] system status summary:', { adb: res.adbAvailable, ios: res.iosAvailable, devices: res.devices, iosDevices: res.iosDevices })
-}).catch((e) => console.warn('[startup] healthcheck failed:', e instanceof Error ? e.message : String(e)))
+if (process.env.MOBILE_DEBUG_MCP_STARTUP_HEALTHCHECK === '1') {
+  getSystemStatus().then((res) => {
+    console.info('[startup] system status summary:', { adb: res.adbAvailable, ios: res.iosAvailable, devices: res.devices, iosDevices: res.iosDevices })
+  }).catch((e) => console.warn('[startup] healthcheck failed:', e instanceof Error ? e.message : String(e)))
+}
 
 const transport = new StdioServerTransport()