@midscene/mcp 0.16.1 → 0.16.2

package/README.md

@@ -1,68 +1,3 @@
 # Midscene MCP
 
-⚠️ Note that midscene is currently only in the experimental stage and not online, and availability is not guaranteed at present
-
-## Usage
-
-## Features
-
-Midscene MCP Server allows you to control browsers using natural language commands, supporting the following features:
-
-- **Page Control:** You can directly control your current browser through the bridge mode provided by chrome devtools
-- **Navigation:** Open URLs, go forward, and go back.
-- **Interaction:** Clicking, Input, and Hovering.
-- **Achieving Goals:** Accomplish tasks by describing goals in natural language, letting AI complete them automatically.
-- **Screenshots:** Capture screenshots of the current page.
-- **JavaScript Execution:** Execute JavaScript code on the current page.
-- **Tab Management:** Get list of tabs, allowing LLM to select which tab to operate on.
-
-> step1:
-* Donwload and Install chrome devtools: https://github.com/web-infra-dev/midscene/actions/runs/14595366638
-* Switch to `Bridge Mode` and click allow connection
-
-> step2:
-* Install Midscene MCP Server:
-
-```json
-{
-  "mcpServers": {
-    "mcp-midscene": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@midscene/mcp@0.15.2-beta-20250422125908.0"
-      ],
-      "env": {
-        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
-        "MIDSCENE_MODEL_NAME": "YOUR_MODEL_NAME",
-        "MCP_SERVER_REQUEST_TIMEOUT": "800000"
-      }
-    }
-  }
-}
-```
-
-* For reference configuration of the model, you can refer to:
-
-## Inspect the MCP server
-
-> [!NOTE]
-
-Starting multiple inspect pages may cause the /message sse link error to occur in MTP
-
-```bash
-# before run this command, you need to build the library first
-pnpm run inspect
-```
-
-
-## TODO
-
-- [x] Support launching in Puppeteer mode
-- [x] Provide comprehensive usage documentation
-- [ ] Provide examples
-- [ ] Optimize automated tests
-- [ ] Test usability/effectiveness
-- Tools
-    - [x] Support getting tab list, allowing LLM to decide which tab to use
-    - [ ] Test effectiveness of controlling Android
+docs: https://midscenejs.com/mcp.html

package/dist/index.cjs

@@ -228,10 +228,6 @@ class MidsceneManager {
                     {
                         type: 'text',
                         text: `Navigated to ${url}`
-                    },
-                    {
-                        type: 'text',
-                        text: `report file: ${agent.reportFile}`
                     }
                 ],
                 isError: false
@@ -505,26 +501,17 @@ const PROMPTS = {
 (0, utils_namespaceObject.setIsMcp)(true);
 const src_server = new mcp_js_namespaceObject.McpServer({
     name: '@midscene/mcp',
-    version: '0.16.1',
+    version: '0.16.2',
     description: 'Midscene MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, and achieving goals. Also supports screenshots and JavaScript execution.'
 });
-src_server.resource('playwright-example', 'file:///playwright-example.mdx', async (uri)=>({
-        contents: [
+src_server.tool('midscene_playwright_example', 'Provides Playwright code examples for Midscene. If users need to generate Midscene test cases, they can call this method to get sample Midscene Playwright test cases for generating end-user test cases. Each step must first be verified using the mcp method, and then the final test case is generated based on the playwright example according to the steps executed by mcp', {}, async ()=>({
+        content: [
             {
-                uri: uri.href,
-                text: PROMPTS.PLAYWRIGHT_CODE_EXAMPLE,
-                mimeType: 'text/plain'
+                type: 'text',
+                text: PROMPTS.PLAYWRIGHT_CODE_EXAMPLE
             }
-        ]
-    }));
-src_server.resource('midscene-api-docs', 'file:///midscene-api-docs.mdx', async (uri)=>({
-        contents: [
-            {
-                uri: uri.href,
-                text: PROMPTS.MIDSCENE_API_DOCS,
-                mimeType: 'text/plain'
-            }
-        ]
+        ],
+        isError: false
     }));
 const midsceneManager = new MidsceneManager(src_server);
 async function runServer() {
@@ -534,8 +521,8 @@ async function runServer() {
 runServer().catch(console.error);
 process.stdin.on('close', ()=>{
     console.error('Midscene MCP Server closing, cleaning up browser...');
-    midsceneManager.closeBrowser().catch(console.error);
     src_server.close();
+    midsceneManager.closeBrowser().catch(console.error);
 });
 for(var __webpack_i__ in __webpack_exports__)exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
 Object.defineProperty(exports, '__esModule', {

package/dist/index.js

@@ -206,10 +206,6 @@ class MidsceneManager {
                     {
                         type: 'text',
                         text: `Navigated to ${url}`
-                    },
-                    {
-                        type: 'text',
-                        text: `report file: ${agent.reportFile}`
                     }
                 ],
                 isError: false
@@ -479,26 +475,17 @@ const PROMPTS = {
 (0, __WEBPACK_EXTERNAL_MODULE__midscene_shared_utils_b0457388__.setIsMcp)(true);
 const src_server = new __WEBPACK_EXTERNAL_MODULE__modelcontextprotocol_sdk_server_mcp_js_2c42c5d0__.McpServer({
     name: '@midscene/mcp',
-    version: '0.16.1',
+    version: '0.16.2',
     description: 'Midscene MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, and achieving goals. Also supports screenshots and JavaScript execution.'
 });
-src_server.resource('playwright-example', 'file:///playwright-example.mdx', async (uri)=>({
-        contents: [
+src_server.tool('midscene_playwright_example', 'Provides Playwright code examples for Midscene. If users need to generate Midscene test cases, they can call this method to get sample Midscene Playwright test cases for generating end-user test cases. Each step must first be verified using the mcp method, and then the final test case is generated based on the playwright example according to the steps executed by mcp', {}, async ()=>({
+        content: [
             {
-                uri: uri.href,
-                text: PROMPTS.PLAYWRIGHT_CODE_EXAMPLE,
-                mimeType: 'text/plain'
+                type: 'text',
+                text: PROMPTS.PLAYWRIGHT_CODE_EXAMPLE
             }
-        ]
-    }));
-src_server.resource('midscene-api-docs', 'file:///midscene-api-docs.mdx', async (uri)=>({
-        contents: [
-            {
-                uri: uri.href,
-                text: PROMPTS.MIDSCENE_API_DOCS,
-                mimeType: 'text/plain'
-            }
-        ]
+        ],
+        isError: false
     }));
 const midsceneManager = new MidsceneManager(src_server);
 async function runServer() {
@@ -508,6 +495,6 @@ async function runServer() {
 runServer().catch(console.error);
 process.stdin.on('close', ()=>{
     console.error('Midscene MCP Server closing, cleaning up browser...');
-    midsceneManager.closeBrowser().catch(console.error);
     src_server.close();
+    midsceneManager.closeBrowser().catch(console.error);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/mcp",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "type": "module",
   "exports": {
     ".": {
@@ -9,9 +9,7 @@
       "require": "./dist/index.cjs"
     }
   },
-  "bin": {
-    "midscene-mcp": "dist/index.cjs"
-  },
+  "bin": "dist/index.cjs",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -30,9 +28,9 @@
     "@modelcontextprotocol/sdk": "1.10.1",
     "puppeteer": "24.2.0",
     "zod": "3.24.3",
-    "@midscene/web": "0.16.1",
-    "@midscene/shared": "0.16.1",
-    "@midscene/core": "0.16.1"
+    "@midscene/shared": "0.16.2",
+    "@midscene/core": "0.16.2",
+    "@midscene/web": "0.16.2"
   },
   "scripts": {
     "build": "rslib build",