shizai-agent-mcp 0.1.2 → 0.2.0

package/README.md

@@ -1,19 +1,19 @@
 # shizai-agent-mcp
 
-实在 Agent 本地 MCP 的 npm/npx 安装器。npm 包只负责下载 GitHub Release 中的编译版 MCP，不包含项目源码。
+实在 Agent 本地 MCP 的 npm/npx 安装器。一个 npm 包同时提供 Shizai MCP、BrowserMCP 和 Playwright MCP 注册能力，用户不需要分别安装多个 npm 包。
 
 ## 使用
 
 ```powershell
 npx -y shizai-agent-mcp install
-npx -y shizai-agent-mcp register codex
+npx -y shizai-agent-mcp register codex --with-browsers
 ```
 
 也可以注册 Cursor 或 Claude Desktop：
 
 ```powershell
-npx -y shizai-agent-mcp register cursor
-npx -y shizai-agent-mcp register claude
+npx -y shizai-agent-mcp register cursor --with-browsers
+npx -y shizai-agent-mcp register claude --with-browsers
 ```
 
 常用命令：
@@ -24,8 +24,12 @@ npx -y shizai-agent-mcp path
 npx -y shizai-agent-mcp uninstall
 ```
 
-当前 npm launcher 版本为 `0.1.2`，默认下载 `v0.5.1` 的 Windows x64 资产：
-`shizai-agent-v0.5.1-windows-x64.zip`。
+当前 npm launcher 版本为 `0.2.0`，默认下载最新的 `v0.6.0` Windows x64 资产：
+`shizai-agent-v0.6.0-windows-x64.zip`。`@playwright/mcp` 会作为 npm 依赖自动安装。
+
+注册默认会加入 `browsermcp` 服务，它配合 Browser MCP Chrome 扩展连接当前已登录标签页；
+`--with-playwright` 或 `--with-browsers` 会额外加入隔离的 `playwright` 服务。
+`--playwright-only` 可关闭默认的 BrowserMCP。
 
 发布 Release 时需要同时上传同名 `.sha256` 文件。测试企业内网镜像时，可设置
 `SHIZAI_AGENT_RELEASE_BASE_URL`；测试其他版本可设置 `SHIZAI_AGENT_VERSION`。

package/bin/shizai-agent-mcp.js

@@ -9,7 +9,9 @@ const { execFileSync, spawn } = require('node:child_process');
 
 const SERVER = 'shizai-agent';
 const REPO = process.env.SHIZAI_AGENT_REPO || 'yimoxzy/shizai-agent';
-const DEFAULT_VERSION = process.env.SHIZAI_AGENT_VERSION || '0.5.1';
+const DEFAULT_VERSION = process.env.SHIZAI_AGENT_VERSION || '0.6.0';
+const BROWSERMCP_VERSION = process.env.SHIZAI_BROWSERMCP_VERSION || '0.1.3';
+const PLAYWRIGHT_VERSION = process.env.SHIZAI_PLAYWRIGHT_VERSION || '0.0.79';
 const installRoot = process.env.SHIZAI_AGENT_HOME || path.join(
   process.env.LOCALAPPDATA || path.join(os.homedir(), '.local'), 'Programs', 'ShizaiAgent'
 );
@@ -17,7 +19,7 @@ const installRoot = process.env.SHIZAI_AGENT_HOME || path.join(
 function fail(message) { console.error(`shizai-agent-mcp: ${message}`); process.exitCode = 1; }
 function json(value) { console.log(JSON.stringify(value, null, 2)); }
 function help() {
-  console.log(`Shizai Agent MCP installer\n\nUsage:\n  shizai-agent-mcp install [--version VERSION]\n  shizai-agent-mcp register <codex|cursor|claude>\n  shizai-agent-mcp status\n  shizai-agent-mcp path\n  shizai-agent-mcp uninstall\n\nEnvironment:\n  SHIZAI_AGENT_VERSION  Release version (default: ${DEFAULT_VERSION})\n  SHIZAI_AGENT_HOME     Installation directory\n  SHIZAI_AGENT_REPO     GitHub repository owner/name\n  SHIZAI_AGENT_RELEASE_BASE_URL  Override release asset base URL\n`);
+  console.log(`Shizai Agent MCP installer\n\nUsage:\n  shizai-agent-mcp install [--version VERSION]\n  shizai-agent-mcp register <codex|cursor|claude> [--with-browsermcp]\n  shizai-agent-mcp register <codex|cursor|claude> [--with-playwright]\n  shizai-agent-mcp register <codex|cursor|claude> --with-browsers\n  shizai-agent-mcp status\n  shizai-agent-mcp path\n  shizai-agent-mcp uninstall\n\nEnvironment:\n  SHIZAI_AGENT_VERSION  Release version (default: ${DEFAULT_VERSION})\n  SHIZAI_AGENT_HOME     Installation directory\n  SHIZAI_AGENT_REPO     GitHub repository owner/name\n  SHIZAI_AGENT_RELEASE_BASE_URL  Override release asset base URL\n  SHIZAI_BROWSERMCP_VERSION  BrowserMCP version (default: ${BROWSERMCP_VERSION})\n  SHIZAI_PLAYWRIGHT_VERSION  Bundled Playwright MCP version (default: ${PLAYWRIGHT_VERSION})\n`);
 }
 function binaryPath() { return path.join(installRoot, 'shizai-agent-mcp.exe'); }
 function psQuote(value) { return `'${String(value).replaceAll("'", "''")}'`; }
@@ -75,16 +77,47 @@ function replaceTomlSection(content, section, replacement) {
   const next = content.replace(pattern, '').trimEnd();
   return `${next}${next ? '\r\n\r\n' : ''}${replacement.trim()}\r\n`;
 }
-function registerCodex() {
+function playwrightSpec() {
+  try {
+    const packageJSON = require.resolve('@playwright/mcp/package.json');
+    const packageRoot = path.dirname(packageJSON);
+    return { command: process.execPath, args: [path.join(packageRoot, 'cli.js')] };
+  } catch (error) {
+    return { command: 'npx', args: ['-y', `@playwright/mcp@${PLAYWRIGHT_VERSION}`] };
+  }
+}
+function browserMcpSpec() {
+  try {
+    const packageJSON = require.resolve('@browsermcp/mcp/package.json');
+    const packageRoot = path.dirname(packageJSON);
+    return { command: process.execPath, args: [path.join(packageRoot, 'dist', 'index.js')] };
+  } catch (error) {
+    return { command: 'npx', args: ['-y', `@browsermcp/mcp@${BROWSERMCP_VERSION}`] };
+  }
+}
+function tomlString(value) { return JSON.stringify(String(value)); }
+function tomlArray(values) { return `[${values.map(tomlString).join(', ')}]`; }
+function registerCodex(withPlaywright = false, withBrowserMcp = true) {
   const config = process.env.SHIZAI_CODEX_CONFIG || path.join(os.homedir(), '.codex', 'config.toml');
   fs.mkdirSync(path.dirname(config), { recursive: true });
   const old = fs.existsSync(config) ? fs.readFileSync(config, 'utf8') : '';
   if (old) fs.copyFileSync(config, `${config}.shizai-agent.bak`);
   const section = `[mcp_servers.${SERVER}]\ncommand = ${psQuote(binaryPath())}\nargs = []\nstartup_timeout_sec = 30\ntool_timeout_sec = 120`;
-  fs.writeFileSync(config, replaceTomlSection(old, `mcp_servers.${SERVER}`, section), 'utf8');
-  json({ registered: true, client: 'codex', config, command: binaryPath() });
+  let next = replaceTomlSection(old, `mcp_servers.${SERVER}`, section);
+  if (withPlaywright) {
+    const spec = playwrightSpec();
+    const browserSection = `[mcp_servers.playwright]\ncommand = ${tomlString(spec.command)}\nargs = ${tomlArray(spec.args)}\nstartup_timeout_sec = 30\ntool_timeout_sec = 120`;
+    next = replaceTomlSection(next, 'mcp_servers.playwright', browserSection);
+  }
+  if (withBrowserMcp) {
+    const spec = browserMcpSpec();
+    const browserMcpSection = `[mcp_servers.browsermcp]\ncommand = ${tomlString(spec.command)}\nargs = ${tomlArray(spec.args)}\nstartup_timeout_sec = 30\ntool_timeout_sec = 120`;
+    next = replaceTomlSection(next, 'mcp_servers.browsermcp', browserMcpSection);
+  }
+  fs.writeFileSync(config, next, 'utf8');
+  json({ registered: true, client: 'codex', config, command: binaryPath(), browsermcp: withBrowserMcp ? browserMcpSpec() : null, playwright: withPlaywright ? playwrightSpec() : null });
 }
-function registerJsonClient(client) {
+function registerJsonClient(client, withPlaywright = false, withBrowserMcp = true) {
   const locations = {
     cursor: process.env.SHIZAI_CURSOR_CONFIG || path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Cursor', 'User', 'globalStorage', 'mcp.json'),
     claude: process.env.SHIZAI_CLAUDE_CONFIG || path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json')
@@ -95,8 +128,16 @@ function registerJsonClient(client) {
   const data = fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf8')) : {};
   data.mcpServers = data.mcpServers || {};
   data.mcpServers[SERVER] = { command: binaryPath(), args: [] };
+  if (withPlaywright) {
+    const spec = playwrightSpec();
+    data.mcpServers.playwright = { command: spec.command, args: spec.args };
+  }
+  if (withBrowserMcp) {
+    const spec = browserMcpSpec();
+    data.mcpServers.browsermcp = { command: spec.command, args: spec.args };
+  }
   fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
-  json({ registered: true, client, config: file, command: binaryPath() });
+  json({ registered: true, client, config: file, command: binaryPath(), browsermcp: withBrowserMcp ? browserMcpSpec() : null, playwright: withPlaywright ? playwrightSpec() : null });
 }
 function launch() {
   if (!fs.existsSync(binaryPath())) install(DEFAULT_VERSION);
@@ -113,11 +154,13 @@ function main() {
   }
   if (command === 'register') {
     if (!fs.existsSync(binaryPath())) throw new Error('尚未安装，请先运行 install');
-    if (target === 'codex') return registerCodex();
-    if (target === 'cursor' || target === 'claude') return registerJsonClient(target);
+    const withPlaywright = rest.includes('--with-playwright') || rest.includes('--with-browsers');
+    const withBrowserMcp = !rest.includes('--playwright-only');
+    if (target === 'codex') return registerCodex(withPlaywright, withBrowserMcp);
+    if (target === 'cursor' || target === 'claude') return registerJsonClient(target, withPlaywright, withBrowserMcp);
     throw new Error('请指定 codex、cursor 或 claude');
   }
-  if (command === 'status') return json({ installed: fs.existsSync(binaryPath()), directory: installRoot, command: binaryPath(), versionFile: path.join(installRoot, 'version.json') });
+  if (command === 'status') return json({ installed: fs.existsSync(binaryPath()), directory: installRoot, command: binaryPath(), versionFile: path.join(installRoot, 'version.json'), browsermcp: browserMcpSpec(), playwright: playwrightSpec() });
   if (command === 'path') return console.log(binaryPath());
   if (command === 'uninstall') { if (fs.existsSync(installRoot)) fs.rmSync(installRoot, { recursive: true, force: true }); return json({ uninstalled: true, directory: installRoot }); }
   throw new Error(`未知命令：${command}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shizai-agent-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Installer and launcher for the Shizai Agent local MCP server",
   "bin": {
     "shizai-agent-mcp": "bin/shizai-agent-mcp.js"
@@ -12,6 +12,10 @@
     "bin",
     "README.md"
   ],
+  "dependencies": {
+    "@browsermcp/mcp": "0.1.3",
+    "@playwright/mcp": "0.0.79"
+  },
   "keywords": ["mcp", "shizai-agent", "codex", "cursor", "claude"],
   "license": "MIT"
 }