phistruct-mcp 0.1.0

package/cli.mjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { spawn, execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createConnection } from "node:net";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+export const BUNDLE_ID = "com.phistruct.app";
+export const BINARY_NAME = "PhiStruct";
+export const MCP_PORT_FIRST = 17321;
+export const MCP_PORT_LAST = 17340;
+
+export function isStdioMcpCommand(command) {
+  return /(?:^|\s)(?:--mcp|-mcp)(?:\s|$)/.test(command);
+}
+
+export function appBinary(appPath) {
+  return join(appPath, "Contents", "MacOS", BINARY_NAME);
+}
+
+export function defaultAppCandidates(home = homedir()) {
+  return [
+    "/Applications/PhiStruct.app",
+    join(home, "Applications", "PhiStruct.app"),
+  ];
+}
+
+export function pickExisting(paths, exists = existsSync) {
+  for (const path of paths) {
+    if (exists(path)) return path;
+  }
+  return null;
+}
+
+export function parseMdfind(output) {
+  return output
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line.endsWith(".app"));
+}
+
+export function findApp({
+  env = process.env,
+  exists = existsSync,
+  home = homedir(),
+  mdfind = runMdfind,
+} = {}) {
+  if (env.PHISTRUCT_BIN && exists(env.PHISTRUCT_BIN)) return env.PHISTRUCT_BIN;
+  if (env.PHISTRUCT_APP) {
+    const bin = appBinary(env.PHISTRUCT_APP);
+    if (exists(bin)) return bin;
+  }
+  const listed = pickExisting(defaultAppCandidates(home), (path) => exists(appBinary(path)));
+  if (listed) return appBinary(listed);
+  for (const app of parseMdfind(mdfind())) {
+    const bin = appBinary(app);
+    if (exists(bin)) return bin;
+  }
+  return null;
+}
+
+function runMdfind() {
+  try {
+    return execFileSync("mdfind", [`kMDItemCFBundleIdentifier == "${BUNDLE_ID}"`], {
+      encoding: "utf8",
+      timeout: 4000,
+    });
+  } catch {
+    return "";
+  }
+}
+
+export function guiIsRunning(bin, listCommands = psCommands) {
+  return listCommands().some((command) => command.includes(bin) && !isStdioMcpCommand(command));
+}
+
+function psCommands() {
+  try {
+    return execFileSync("ps", ["-ax", "-o", "args="], { encoding: "utf8" }).split("\n");
+  } catch {
+    return [];
+  }
+}
+
+export function tcpOpen(port, host = "127.0.0.1", timeoutMs = 250) {
+  return new Promise((resolveOpen) => {
+    const socket = createConnection({ host, port });
+    const done = (ok) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolveOpen(ok);
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => done(true));
+    socket.once("timeout", () => done(false));
+    socket.once("error", () => done(false));
+  });
+}
+
+export async function waitForLiveMcp({
+  first = MCP_PORT_FIRST,
+  last = MCP_PORT_LAST,
+  timeoutMs = 25_000,
+  probe = tcpOpen,
+  now = Date.now,
+  sleep = (ms) => new Promise((r) => setTimeout(r, ms)),
+} = {}) {
+  const start = now();
+  while (now() - start < timeoutMs) {
+    for (let port = first; port <= last; port++) {
+      if (await probe(port)) return port;
+    }
+    await sleep(200);
+  }
+  return null;
+}
+
+function fail(message) {
+  process.stderr.write(`${message}\n`);
+  process.exit(1);
+}
+
+async function main() {
+  if (process.platform !== "darwin") {
+    fail("PhiStruct MCP opens PhiStruct.app and only runs on macOS.");
+  }
+  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();
+  }
+  const port = await waitForLiveMcp();
+  if (port == null) {
+    fail("PhiStruct opened but MCP did not listen on 127.0.0.1:17321–17340.");
+  }
+  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) {
+  main().catch((err) => fail(err instanceof Error ? err.message : String(err)));
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "phistruct-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "MCP stdio bridge that opens PhiStruct.app for Cursor, Claude, and other IDEs",
+  "bin": {
+    "phistruct-mcp": "./cli.mjs"
+  },
+  "files": [
+    "cli.mjs"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "phistruct"
+  ]
+}