phistruct-mcp 0.1.0 → 0.1.2

package/cli.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { spawn, execFileSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { execFileSync, spawn } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
 import { createConnection } from "node:net";
 import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 export const BUNDLE_ID = "com.phistruct.app";
 export const BINARY_NAME = "PhiStruct";
@@ -71,8 +71,24 @@ function runMdfind() {
   }
 }
 
+/** A visible PhiStruct window, including a different copy than `bin`. Ignores the hidden --mcp helper. */
+export function isGuiCommand(command, bin) {
+  if (!command || isStdioMcpCommand(command)) return false;
+  if (bin && command.includes(bin)) return true;
+  return /\/MacOS\/PhiStruct(?:\s|$)/.test(command);
+}
+
+export function runningGuiBinary(listCommands = psCommands) {
+  for (const command of listCommands()) {
+    if (!isGuiCommand(command)) continue;
+    const match = command.match(/(\/\S+\/MacOS\/PhiStruct)(?:\s|$)/);
+    if (match) return match[1];
+  }
+  return null;
+}
+
 export function guiIsRunning(bin, listCommands = psCommands) {
-  return listCommands().some((command) => command.includes(bin) && !isStdioMcpCommand(command));
+  return listCommands().some((command) => isGuiCommand(command, bin));
 }
 
 function psCommands() {
@@ -116,34 +132,132 @@ export async function waitForLiveMcp({
   return null;
 }
 
+export const SERVER_NAME = "phistruct";
+export const SERVER_ENTRY = {
+  command: "npx",
+  args: ["-y", "phistruct-mcp"],
+};
+
+export function mergeMcpDocument(raw, name = SERVER_NAME, entry = SERVER_ENTRY) {
+  const text = (raw ?? "").replace(/^\uFEFF/, "").trim();
+  let data = {};
+  if (text) {
+    data = JSON.parse(text);
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+      throw new Error("MCP config is not a JSON object");
+    }
+  }
+  if (
+    !data.mcpServers ||
+    typeof data.mcpServers !== "object" ||
+    Array.isArray(data.mcpServers)
+  ) {
+    data.mcpServers = {};
+  }
+  data.mcpServers[name] = { ...entry };
+  return data;
+}
+
+export function defaultConfigPaths(home = homedir(), platform = process.platform) {
+  const paths = [{ path: join(home, ".cursor", "mcp.json"), create: "always" }];
+  if (platform === "darwin") {
+    paths.push({
+      path: join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+      create: "if-parent",
+    });
+  } else if (platform === "win32") {
+    const appdata = process.env.APPDATA;
+    if (appdata) {
+      paths.push({ path: join(appdata, "Claude", "claude_desktop_config.json"), create: "if-parent" });
+    }
+  }
+  paths.push({ path: join(home, ".claude.json"), create: "if-file" });
+  return paths;
+}
+
+export function shouldWriteConfig({ path, create }, exists = existsSync) {
+  if (create === "always") return true;
+  if (create === "if-file") return exists(path);
+  return exists(path) || exists(dirname(path));
+}
+
+export function writeMergedConfig(path, raw) {
+  const data = mergeMcpDocument(raw);
+  mkdirSync(dirname(path), { recursive: true });
+  const tmp = `${path}.${process.pid}.tmp`;
+  writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`);
+  renameSync(tmp, path);
+  return path;
+}
+
+export function setupConfigs({
+  home = homedir(),
+  platform = process.platform,
+  exists = existsSync,
+  read = (p) => readFileSync(p, "utf8"),
+} = {}) {
+  const written = [];
+  for (const spec of defaultConfigPaths(home, platform)) {
+    if (!shouldWriteConfig(spec, exists)) continue;
+    const raw = exists(spec.path) ? read(spec.path) : "";
+    writeMergedConfig(spec.path, raw);
+    written.push(spec.path);
+  }
+  if (written.length === 0) {
+    throw new Error("No MCP config files to write");
+  }
+  return written;
+}
+
+export const WINDOW_CLOSED_MESSAGE = "PhiStruct 窗口没开。请先自己打开 PhiStruct。";
+
 function fail(message) {
   process.stderr.write(`${message}\n`);
   process.exit(1);
 }
 
+/** Use the app's own helper so sandboxed UserDefaults stay inside the app container. */
+export function runStdioBridge({
+  bin = runningGuiBinary(),
+  spawnProcess = spawn,
+  onExit = (code) => process.exit(code ?? 1),
+} = {}) {
+  if (!bin) throw new Error(WINDOW_CLOSED_MESSAGE);
+  const child = spawnProcess(bin, ["--mcp"], { stdio: "inherit" });
+  child.once("error", (err) => {
+    process.stderr.write(`Could not connect to PhiStruct MCP: ${err.message}\n`);
+    onExit(1);
+  });
+  child.once("exit", (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    else onExit(code);
+  });
+  return child;
+}
+
 async function main() {
-  if (process.platform !== "darwin") {
-    fail("PhiStruct MCP opens PhiStruct.app and only runs on macOS.");
+  const argv = process.argv.slice(2).filter((a) => a !== "--");
+  if (argv[0] === "setup" || argv[0] === "install") {
+    const written = setupConfigs();
+    for (const path of written) process.stderr.write(`Wrote ${path}\n`);
+    return;
   }
-  const bin = findApp();
-  if (!bin) {
-    fail("PhiStruct.app not found. Install PhiStruct, then try again.");
-  }
-  if (!guiIsRunning(bin)) {
-    spawn(bin, [], { detached: true, stdio: "ignore" }).unref();
+  if (process.platform !== "darwin") {
+    fail("PhiStruct MCP only runs on macOS.");
   }
-  const port = await waitForLiveMcp();
-  if (port == null) {
-    fail("PhiStruct opened but MCP did not listen on 127.0.0.1:17321–17340.");
+  runStdioBridge();
+}
+
+function isDirectRun() {
+  const argv1 = process.argv[1];
+  if (!argv1) return false;
+  try {
+    return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(resolve(argv1));
+  } catch {
+    return false;
   }
-  const child = spawn(bin, ["--mcp"], { stdio: "inherit" });
-  child.on("exit", (code, signal) => {
-    if (signal) process.kill(process.pid, signal);
-    process.exit(code ?? 1);
-  });
 }
 
-const entry = process.argv[1] ? pathToFileURL(resolve(process.argv[1])).href : "";
-if (import.meta.url === entry) {
+if (isDirectRun()) {
   main().catch((err) => fail(err instanceof Error ? err.message : String(err)));
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "phistruct-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "description": "MCP stdio bridge that opens PhiStruct.app for Cursor, Claude, and other IDEs",
+  "description": "MCP stdio bridge for an already-open PhiStruct window. Does not launch the app.",
   "bin": {
     "phistruct-mcp": "./cli.mjs"
   },