refactor(shared): remove zod dependency and clean up README files across packages

quanru · quanru · commit cca5719e7b95 · 2025-11-27T09:50:23.000+08:00
diff --git a/packages/android-mcp/README.md b/packages/android-mcp/README.md
@@ -1,70 +1,3 @@
-# @midscene/android-mcp
+# Midscene MCP
 
-Midscene MCP Server for Android automation.
-
-## Installation
-
-```bash
-npm install @midscene/android-mcp
-```
-
-## Prerequisites
-
-- Android Debug Bridge (ADB) installed and available in PATH
-- At least one Android device connected via USB or emulator running
-
-## Usage
-
-### CLI Mode
-
-```bash
-npx @midscene/android-mcp
-```
-
-### Programmatic API
-
-```typescript
-import { AndroidMCPServer } from '@midscene/android-mcp';
-
-const server = new AndroidMCPServer();
-await server.launch();
-```
-
-## Available Tools
-
-### Action Space Tools
-
-Dynamically generated from AndroidAgent's action space:
-
-- `launch` - Launch an Android app or URL
-- `tap` - Tap on UI elements
-- `input` - Input text into fields
-- `swipe` - Swipe gestures
-- `back` - Android back button
-- `home` - Android home button
-- `recentApps` - Recent apps button
-- `runAdbShell` - Execute ADB shell commands
-
-### Common Tools
-
-- `take_screenshot` - Capture screenshot of current screen
-- `wait_for` - Wait until condition becomes true
-- `assert` - Assert condition is true
-
-### Platform-Specific Tools
-
-- `android_connect` - Connect to a specific Android device by device ID
-- `android_list_devices` - List all connected Android devices
-
-## Configuration
-
-Set environment variables in `.env`:
-
-```bash
-OPENAI_API_KEY=your_api_key
-MIDSCENE_MODEL_NAME=qwen3-vl-plus
-```
-
-## License
-
-MIT
+docs: https://midscenejs.com/mcp.html
diff --git a/packages/android-mcp/package.json b/packages/android-mcp/package.json
@@ -34,8 +34,7 @@
     "@types/node": "^18.0.0",
     "dotenv": "^16.4.5",
     "typescript": "^5.8.3",
-    "vitest": "3.0.5",
-    "zod": "3.24.3"
+    "vitest": "3.0.5"
   },
   "dependencies": {
     "@silvia-odwyer/photon": "0.3.3",
diff --git a/packages/android-mcp/rslib.config.ts b/packages/android-mcp/rslib.config.ts
@@ -1,4 +1,3 @@
-import path from 'node:path';
 import { defineConfig } from '@rslib/core';
 import { version } from './package.json';
 
diff --git a/packages/android-mcp/src/android-tools.ts b/packages/android-mcp/src/android-tools.ts
@@ -1,8 +1,8 @@
 import { type AndroidAgent, agentFromAdbDevice } from '@midscene/android';
+import { z } from '@midscene/core';
 import { parseBase64 } from '@midscene/shared/img';
 import { getDebug } from '@midscene/shared/logger';
 import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
-import { z } from 'zod';
 
 const debug = getDebug('mcp:android-tools');
 
diff --git a/packages/core/src/ai-model/inspect.ts b/packages/core/src/ai-model/inspect.ts
@@ -140,9 +140,7 @@ export async function AiLocateElement(options: {
   const targetElementDescriptionText = extraTextFromUserPrompt(
     targetElementDescription,
   );
-  const userInstructionPrompt = findElementPrompt(
-    targetElementDescriptionText,
-  );
+  const userInstructionPrompt = findElementPrompt(targetElementDescriptionText);
   const systemPrompt = systemPromptToLocateElement(vlMode);
 
   let imagePayload = screenshotBase64;
diff --git a/packages/ios-mcp/README.md b/packages/ios-mcp/README.md
@@ -1,69 +1,3 @@
 # @midscene/ios-mcp
 
-Midscene MCP Server for iOS automation.
-
-## Installation
-
-```bash
-npm install @midscene/ios-mcp
-```
-
-## Prerequisites
-
-- macOS with Xcode installed
-- iOS Simulator or physical iOS device
-- WebDriverAgent set up (automatically detected)
-
-## Usage
-
-### CLI Mode
-
-```bash
-npx @midscene/ios-mcp
-```
-
-### Programmatic API
-
-```typescript
-import { IOSMCPServer } from '@midscene/ios-mcp';
-
-const server = new IOSMCPServer();
-await server.launch();
-```
-
-## Available Tools
-
-### Action Space Tools
-
-Dynamically generated from IOSAgent's action space:
-
-- `launch` - Launch an iOS app or URL
-- `tap` - Tap on UI elements
-- `input` - Input text into fields
-- `swipe` - Swipe gestures
-- `home` - iOS home button
-- `appSwitcher` - iOS app switcher
-- `runWdaRequest` - Execute WebDriverAgent API requests
-
-### Common Tools
-
-- `take_screenshot` - Capture screenshot of current screen
-- `wait_for` - Wait until condition becomes true
-- `assert` - Assert condition is true
-
-### Platform-Specific Tools
-
-- `ios_check_environment` - Check iOS environment availability (Xcode, simulators, WebDriverAgent)
-
-## Configuration
-
-Set environment variables in `.env`:
-
-```bash
-OPENAI_API_KEY=your_api_key
-MIDSCENE_MODEL_NAME=qwen3-vl-plus
-```
-
-## License
-
-MIT
+docs: https://midscenejs.com/mcp.html
diff --git a/packages/ios-mcp/package.json b/packages/ios-mcp/package.json
@@ -34,8 +34,7 @@
     "@types/node": "^18.0.0",
     "dotenv": "^16.4.5",
     "typescript": "^5.8.3",
-    "vitest": "3.0.5",
-    "zod": "3.24.3"
+    "vitest": "3.0.5"
   },
   "dependencies": {
     "@silvia-odwyer/photon": "0.3.3",
diff --git a/packages/ios-mcp/src/ios-tools.ts b/packages/ios-mcp/src/ios-tools.ts
@@ -2,7 +2,6 @@ import { type IOSAgent, agentFromWebDriverAgent } from '@midscene/ios';
 import { parseBase64 } from '@midscene/shared/img';
 import { getDebug } from '@midscene/shared/logger';
 import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
-import { z } from 'zod';
 
 const debug = getDebug('mcp:ios-tools');
 
diff --git a/packages/mcp/package.json b/packages/mcp/package.json
@@ -36,8 +36,7 @@
     "dotenv": "^16.4.5",
     "puppeteer-core": "24.2.0",
     "typescript": "^5.8.3",
-    "vitest": "3.0.5",
-    "zod": "3.24.3"
+    "vitest": "3.0.5"
   },
   "dependencies": {
     "@silvia-odwyer/photon": "0.3.3",
diff --git a/packages/mcp/src/web-tools.ts b/packages/mcp/src/web-tools.ts
@@ -1,10 +1,10 @@
+import { z } from '@midscene/core';
 import {
   MIDSCENE_MCP_USE_PUPPETEER_MODE,
   globalConfigManager,
 } from '@midscene/shared/env';
 import { BaseMidsceneTools, type ToolDefinition } from '@midscene/shared/mcp';
 import { AgentOverChromeBridge } from '@midscene/web/bridge-mode';
-import { z } from 'zod';
 import { type PuppeteerBrowserAgent, ensureBrowser } from './puppeteer';
 
 export class WebMidsceneTools extends BaseMidsceneTools {
diff --git a/packages/shared/src/mcp/base-tools.ts b/packages/shared/src/mcp/base-tools.ts
@@ -42,7 +42,7 @@ export abstract class BaseMidsceneTools implements IMidsceneTools {
       this.ensureAgent(),
     );
 
-    // 3. Add common tools (screenshot, waitFor, assert)
+    // 3. Add common tools (screenshot, waitFor)
     const commonTools = generateCommonTools(() => this.ensureAgent());
 
     // 4. Add platform-specific tools (device connection, etc.)
diff --git a/packages/shared/src/mcp/tool-generator.ts b/packages/shared/src/mcp/tool-generator.ts
@@ -26,7 +26,7 @@ export function generateToolsFromActionSpace(
       const agent = await getAgent();
 
       // Call the action through agent's action method
-      const result = await agent.action(`Use the action "${action.name}"`, {
+      await agent.action(`Use the action "${action.name}"`, {
         planType: action.name,
         ...args,
       });
@@ -90,6 +90,7 @@ export function generateCommonTools(
         await agent.aiWaitFor(assertion, { timeoutMs, checkIntervalMs });
         return {
           content: [{ type: 'text', text: `Condition met: "${assertion}"` }],
+          isError: false,
         };
       },
       autoDestroy: true,
diff --git a/packages/web-mcp/README.md b/packages/web-mcp/README.md
@@ -1,44 +1,3 @@
-# @midscene/web-mcp
+# Midscene MCP
 
-Midscene MCP Server for Web automation (alias for @midscene/mcp).
-
-This package is an alias for `@midscene/mcp`, which provides web automation capabilities.
-
-## Installation
-
-```bash
-npm install @midscene/web-mcp
-```
-
-Or use the original package:
-
-```bash
-npm install @midscene/mcp
-```
-
-## Usage
-
-See [@midscene/mcp documentation](../mcp/README.md) for full usage instructions.
-
-### CLI Mode
-
-```bash
-npx @midscene/web-mcp
-```
-
-### Programmatic API
-
-```typescript
-import { WebMCPServer } from '@midscene/web-mcp';
-
-const server = new WebMCPServer();
-await server.launch();
-```
-
-## Available Tools
-
-All tools from @midscene/mcp are available. See the main MCP package for details.
-
-## License
-
-MIT
+docs: https://midscenejs.com/mcp.html
diff --git a/packages/web-mcp/src/index.ts b/packages/web-mcp/src/index.ts
@@ -1,4 +1,6 @@
 #!/usr/bin/env node
-// Re-export from @midscene/mcp
-export * from '@midscene/mcp';
-import('@midscene/mcp').catch(console.error);
+import { WebMCPServer } from './server.js';
+
+// CLI entry: create and launch web MCP server
+const server = new WebMCPServer();
+server.launch().catch(console.error);
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-import path from 'node:path';`
`2`	`1`	`import { defineConfig } from '@rslib/core';`
`3`	`2`	`import { version } from './package.json';`
`4`	`3`