record_safer_pro_mcp 1.0.0 → 1.0.1

package/README.md

@@ -78,6 +78,24 @@ npx -v
 
 MCP Server 会自动发现后端连接地址，无需手动配置端口。每次启动时会自动获取最新版本，无需手动更新。
 
+### 4. 验证安装是否成功
+
+如果你想单独验证 npm 包是否安装可用，不要只看 `npx -y record_safer_pro_mcp` 是否“卡住”。
+
+这个命令默认会启动 `stdio` MCP Server 并持续等待客户端连接，所以终端看起来像“没有输出”或“挂住”，这是正常行为，不代表安装失败。
+
+建议用下面两个命令做一次性验证：
+
+```bash
+npx -y record_safer_pro_mcp --version
+npx -y record_safer_pro_mcp --doctor
+```
+
+预期结果：
+
+- `--version` 会输出当前已发布版本
+- `--doctor` 会输出 JSON，自检当前 Node 版本与传输模式
+
 ---
 
 ## 功能一览
@@ -184,6 +202,16 @@ npx record_safer_pro_mcp
 **Q: 提示找不到 npx 命令？**
 需要安装 Node.js >= 18。访问 https://nodejs.org 下载安装。
 
+**Q: 我在终端里运行 `npx -y record_safer_pro_mcp` 后没有任何输出，是不是安装失败了？**
+不是。默认模式是 `stdio` MCP Server，会一直等待 Claude / Cursor / Kiro 之类的客户端接管。请改用：
+
+```bash
+npx -y record_safer_pro_mcp --version
+npx -y record_safer_pro_mcp --doctor
+```
+
+如果这两个命令能正常输出，说明 npm 包安装和启动链路是正常的。
+
 **Q: 端口不是 8080 怎么办？**
 正常情况下不需要手动处理，应用会自动写入端口文件。如果确实需要手动指定，设置环境变量：
 ```json

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+export interface CliContext {
+    packageName: string;
+    version: string;
+    nodeVersion: string;
+    transport: string;
+}
+export type CliAction = {
+    kind: "start";
+} | {
+    kind: "stdout";
+    text: string;
+    exitCode: number;
+} | {
+    kind: "stderr";
+    text: string;
+    exitCode: number;
+};
+export declare function resolveCliAction(args: string[], context: CliContext): CliAction;
+export declare function handleCliArgs(args: string[], stdout?: Pick<NodeJS.WriteStream, "write">, stderr?: Pick<NodeJS.WriteStream, "write">): Promise<boolean>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AA6BvD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,CAoC/E;AAkBD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,GAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAkB,EAC1D,MAAM,GAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAkB,GACzD,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/cli.js

@@ -0,0 +1,81 @@
+import { readFile } from "node:fs/promises";
+import { resolveRuntimeConfig } from "./runtime.js";
+const HELP_TEXT = `Record Safer Pro MCP Server
+
+Usage:
+  record_safer_pro_mcp                Start the stdio MCP server
+  record_safer_pro_mcp --version      Print the published package version
+  record_safer_pro_mcp --doctor       Print environment diagnostics and exit
+  record_safer_pro_mcp --help         Show this help
+
+Notes:
+  - Running without arguments starts a stdio MCP server and waits for the client.
+  - In a normal terminal this often looks like "no output" or "hang", which is expected.
+  - Typical client config uses: npx -y record_safer_pro_mcp`;
+function buildDoctorReport(context) {
+    return JSON.stringify({
+        ok: true,
+        packageName: context.packageName,
+        version: context.version,
+        nodeVersion: context.nodeVersion,
+        transport: context.transport,
+    }, null, 2);
+}
+export function resolveCliAction(args, context) {
+    if (args.length === 0) {
+        return { kind: "start" };
+    }
+    const [firstArg] = args;
+    if (firstArg === "--help" || firstArg === "-h") {
+        return {
+            kind: "stdout",
+            text: `${HELP_TEXT}\n`,
+            exitCode: 0,
+        };
+    }
+    if (firstArg === "--version" || firstArg === "-v") {
+        return {
+            kind: "stdout",
+            text: `${context.packageName} ${context.version}\n`,
+            exitCode: 0,
+        };
+    }
+    if (firstArg === "--doctor") {
+        return {
+            kind: "stdout",
+            text: `${buildDoctorReport(context)}\n`,
+            exitCode: 0,
+        };
+    }
+    return {
+        kind: "stderr",
+        text: `Unknown argument: ${firstArg}\n\n${HELP_TEXT}\n`,
+        exitCode: 1,
+    };
+}
+async function loadPackageContext() {
+    const packageJsonUrl = new URL("../package.json", import.meta.url);
+    const packageJson = JSON.parse(await readFile(packageJsonUrl, "utf8"));
+    const runtimeConfig = resolveRuntimeConfig();
+    return {
+        packageName: packageJson.name ?? "record_safer_pro_mcp",
+        version: packageJson.version ?? "0.0.0",
+        nodeVersion: process.versions.node,
+        transport: runtimeConfig.transport,
+    };
+}
+export async function handleCliArgs(args, stdout = process.stdout, stderr = process.stderr) {
+    const action = resolveCliAction(args, await loadPackageContext());
+    if (action.kind === "start") {
+        return false;
+    }
+    if (action.kind === "stdout") {
+        stdout.write(action.text);
+    }
+    else {
+        stderr.write(action.text);
+    }
+    process.exitCode = action.exitCode;
+    return true;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import { handleCliArgs } from "./cli.js";
 import { startRuntime } from "./runtime.js";
-await startRuntime();
+if (!(await handleCliArgs(process.argv.slice(2)))) {
+    await startRuntime();
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "record_safer_pro_mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Record Safer Pro MCP Server — 专业多通道录音软件 AI 接口 / Professional multi-channel recording software AI interface",
   "type": "module",
   "main": "dist/index.js",