shizai-agent-mcp 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# shizai-agent-mcp
+
+实在 Agent 本地 MCP 的 npm/npx 安装器。npm 包只负责下载 GitHub Release 中的编译版 MCP，不包含项目源码。
+
+## 使用
+
+```powershell
+npx -y shizai-agent-mcp install
+npx -y shizai-agent-mcp register codex
+```
+
+也可以注册 Cursor 或 Claude Desktop：
+
+```powershell
+npx -y shizai-agent-mcp register cursor
+npx -y shizai-agent-mcp register claude
+```
+
+常用命令：
+
+```powershell
+npx -y shizai-agent-mcp status
+npx -y shizai-agent-mcp path
+npx -y shizai-agent-mcp uninstall
+```
+
+默认下载 `v0.5.0` 的 Windows x64 资产：
+`shizai-agent-v0.5.0-windows-x64.zip`。
+
+发布 Release 时需要同时上传同名 `.sha256` 文件。测试企业内网镜像时，可设置
+`SHIZAI_AGENT_RELEASE_BASE_URL`；测试其他版本可设置 `SHIZAI_AGENT_VERSION`。
+
+本地设计器需要正在运行且已登录。MCP 是本地 stdio 服务，Codex 显示 `Auth: Unsupported`
+属于正常状态，实在 Agent 的登录会话由桌面设计器提供。

package/bin/shizai-agent-mcp.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+/* Lightweight distribution layer. The MCP binary remains in GitHub Releases. */
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+const crypto = require('node:crypto');
+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.0';
+const installRoot = process.env.SHIZAI_AGENT_HOME || path.join(
+  process.env.LOCALAPPDATA || path.join(os.homedir(), '.local'), 'Programs', 'ShizaiAgent'
+);
+
+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`);
+}
+function binaryPath() { return path.join(installRoot, 'shizai-agent-mcp.exe'); }
+function psQuote(value) { return `'${String(value).replaceAll("'", "''")}'`; }
+function runPowerShell(script, args = []) {
+  return execFileSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', script, ...args], { encoding: 'utf8' });
+}
+function assetName(version) {
+  if (process.platform !== 'win32' || process.arch !== 'x64') {
+    throw new Error(`当前 npm 安装器暂时只提供 Windows x64，检测到 ${process.platform}/${process.arch}`);
+  }
+  return process.env.SHIZAI_AGENT_ASSET_NAME || `shizai-agent-v${version}-windows-x64.zip`;
+}
+function releaseUrl(version, asset) {
+  const base = process.env.SHIZAI_AGENT_RELEASE_BASE_URL || `https://github.com/${REPO}/releases/download/v${version}`;
+  return `${base.replace(/\/$/, '')}/${asset}`;
+}
+function verifySha256(file, expected) {
+  const actual = crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex').toLowerCase();
+  if (actual !== expected.toLowerCase()) throw new Error(`SHA256 校验失败：期望 ${expected}，实际 ${actual}`);
+}
+function download(url, destination) {
+  const script = `Invoke-WebRequest -UseBasicParsing -Uri ${psQuote(url)} -OutFile ${psQuote(destination)}`;
+  runPowerShell(script);
+}
+function install(version) {
+  const asset = assetName(version);
+  const url = releaseUrl(version, asset);
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), 'shizai-agent-'));
+  const archive = path.join(temp, asset);
+  const checksum = path.join(temp, `${asset}.sha256`);
+  try {
+    console.log(`下载 ${url}`);
+    download(url, archive);
+    try {
+      download(`${url}.sha256`, checksum);
+      const text = fs.readFileSync(checksum, 'utf8');
+      const expected = (text.match(/[a-f0-9]{64}/i) || [])[0];
+      if (expected) verifySha256(archive, expected);
+    } catch (error) {
+      if (process.env.SHIZAI_AGENT_REQUIRE_CHECKSUM === '1') throw error;
+      console.warn('未找到校验文件，继续解压；发布正式版本时建议上传 .sha256。');
+    }
+    fs.mkdirSync(installRoot, { recursive: true });
+    runPowerShell(`if (Test-Path -LiteralPath ${psQuote(installRoot)}) { Remove-Item -LiteralPath ${psQuote(installRoot)} -Recurse -Force }; New-Item -ItemType Directory -Force -Path ${psQuote(installRoot)} | Out-Null; Expand-Archive -LiteralPath ${psQuote(archive)} -DestinationPath ${psQuote(installRoot)} -Force; $nested = Get-ChildItem -LiteralPath ${psQuote(installRoot)} -Directory | Where-Object { Test-Path -LiteralPath (Join-Path $_.FullName 'shizai-agent-mcp.exe') } | Select-Object -First 1; if ($nested) { Get-ChildItem -LiteralPath $nested.FullName -Force | Move-Item -Destination ${psQuote(installRoot)} -Force }`);
+    if (!fs.existsSync(binaryPath())) throw new Error(`安装包中未找到 ${binaryPath()}`);
+    fs.writeFileSync(path.join(installRoot, 'version.json'), JSON.stringify({ version, asset, installedAt: new Date().toISOString() }, null, 2));
+    json({ installed: true, version, directory: installRoot, command: binaryPath() });
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true });
+  }
+}
+function replaceTomlSection(content, section, replacement) {
+  const escaped = section.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const pattern = new RegExp(`(?ms)^\\[${escaped}\\]\\r?\\n.*?(?=^\\[|$)`);
+  const next = content.replace(pattern, '').trimEnd();
+  return `${next}${next ? '\\r\\n\\r\\n' : ''}${replacement.trim()}\\r\\n`;
+}
+function registerCodex() {
+  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() });
+}
+function registerJsonClient(client) {
+  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')
+  };
+  const file = locations[client];
+  if (!file) throw new Error(`未知客户端：${client}`);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const data = fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf8')) : {};
+  data.mcpServers = data.mcpServers || {};
+  data.mcpServers[SERVER] = { command: binaryPath(), args: [] };
+  fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+  json({ registered: true, client, config: file, command: binaryPath() });
+}
+function launch() {
+  if (!fs.existsSync(binaryPath())) install(DEFAULT_VERSION);
+  const child = spawn(binaryPath(), process.argv.slice(2), { stdio: 'inherit', windowsHide: true });
+  child.on('exit', code => { process.exitCode = code ?? 0; });
+}
+function main() {
+  const [command, target, ...rest] = process.argv.slice(2);
+  if (!command) return launch();
+  if (command === '--help' || command === '-h') return help();
+  if (command === 'install') {
+    const index = rest.indexOf('--version');
+    return install(index >= 0 ? rest[index + 1] : (target && !target.startsWith('-') ? target : DEFAULT_VERSION));
+  }
+  if (command === 'register') {
+    if (!fs.existsSync(binaryPath())) throw new Error('尚未安装，请先运行 install');
+    if (target === 'codex') return registerCodex();
+    if (target === 'cursor' || target === 'claude') return registerJsonClient(target);
+    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 === '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}`);
+}
+try { main(); } catch (error) { fail(error.message); }

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "shizai-agent-mcp",
+  "version": "0.1.0",
+  "description": "Installer and launcher for the Shizai Agent local MCP server",
+  "bin": {
+    "shizai-agent-mcp": "bin/shizai-agent-mcp.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": ["mcp", "shizai-agent", "codex", "cursor", "claude"],
+  "license": "MIT"
+}