@fragments_awe/ops-mcp 0.0.0-stage → 0.14.0

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# Ops MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+需要 Node.js 18+。支持 macOS Apple/Intel、Windows x64、Linux x64。
+
+```sh
+npm install -g @fragments_awe/ops-mcp
+ops-mcp login us_east
+```
+
+国内登录用 `ops-mcp login cn`，新加坡用 `ops-mcp login singapore`。在浏览器完成飞书授权。
+
+AI 客户端的 MCP 配置：
+
+```json
+{
+  "mcpServers": {
+    "wgops": {
+      "command": "ops-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Claude Code 可执行 `claude mcp add --transport stdio --scope user wgops -- ops-mcp`。
+如果图形客户端找不到命令，使用 `which ops-mcp`（Windows 用 `where ops-mcp`）输出的完整路径。
+
+对 AI 说“先绑定美东路演，再列出测试集合”。区域分别是 `cn_dev`、`singapore_dev`、`us_east_exhibition`。
+
+MCP 启动后后台查询 npm latest，检查结果缓存 24 小时，长驻进程每 24 小时再次检查。
+发现新版会在绑定区域后的一次成功工具调用中附带更新提醒，由 AI 转述；不保证客户端弹出通知。
+
+```sh
+npm install -g @fragments_awe/ops-mcp@latest
+```
+
+更新后重启客户端里的 MCP。登录凭据仍保存在 `~/.wgops-mcp/session.json`，不包含在 npm 包中。
+
+维护者从仓库 backend 目录构建，再进入 npm/ops-mcp 发布：
+
+```sh
+GOTOOLCHAIN=auto go run ./cmd/package-ops-mcp --npm-output ../npm/ops-mcp
+cd ../npm/ops-mcp
+npm test
+npm pack
+npm publish --access public
+```
+
+发布前同步修改 `backend/internal/opsmcp/version.go` 与 `package.json` 的版本，构建及 prepack 都会验证版本一致。

package/index.cjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process')
+const { existsSync } = require('node:fs')
+const { join } = require('node:path')
+
+const platform = `${process.platform}-${process.arch}`
+const binary = join(__dirname, 'bin', platform, process.platform === 'win32' ? 'ops-mcp.exe' : 'ops-mcp')
+if (!existsSync(binary)) {
+  console.error(`Ops MCP 暂不支持 ${platform}。支持 macOS arm64/x64、Windows x64 和 Linux x64。`)
+  process.exit(1)
+}
+
+// stdin/stdout 原样交给 Go MCP；启动器日志只能写 stderr，避免破坏 JSON-RPC。
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' })
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => child.kill(signal))
+}
+child.on('error', error => {
+  console.error(`Ops MCP 启动失败：${error.message}`)
+  process.exitCode = 1
+})
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal)
+    process.kill(process.pid, signal)
+  } else {
+    process.exitCode = code ?? 1
+  }
+})

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@fragments_awe/ops-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.14.0",
+  "description": "WG Ops MCP tools for local AI clients",
+  "license": "UNLICENSED",
+  "bin": { "ops-mcp": "index.cjs" },
+  "files": ["index.cjs", "bin/", "README.md"],
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
+  "scripts": {
+    "test": "node --test launcher.test.cjs",
+    "prepack": "node verify-package.cjs"
+  }
+}