localization-mcp-server 1.0.0 → 1.0.1

package/dist/index.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+const args = process.argv.slice(2);
+if (args[0] === "setup") {
+    const { runSetup } = await import("./setup.js");
+    await runSetup(args.slice(1));
+    process.exit(0);
+}
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server.js";
 // Load .env from the mcp-server directory (one level above dist/)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,kEAAkE;AAClE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+EAA+E,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,kEAAkE;AAClE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+EAA+E,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetup(args: string[]): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AA0DA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC5D"}

package/dist/setup.js

@@ -0,0 +1,87 @@
+import { execSync } from "child_process";
+const BOLD = "\x1b[1m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const RESET = "\x1b[0m";
+const ok = (msg) => console.log(`${GREEN}✓${RESET} ${msg}`);
+const fail = (msg) => console.error(`${RED}✗${RESET} ${msg}`);
+const warn = (msg) => console.log(`${YELLOW}!${RESET} ${msg}`);
+function parseArgs(args) {
+    const tokenIdx = args.indexOf("--token");
+    const backendIdx = args.indexOf("--backend-url");
+    return {
+        token: tokenIdx !== -1 ? args[tokenIdx + 1] : undefined,
+        backendUrl: backendIdx !== -1 ? args[backendIdx + 1] : undefined,
+    };
+}
+function checkClaudeCli() {
+    try {
+        execSync("claude --version", { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function removeOldRegistration() {
+    try {
+        execSync('claude mcp remove "localization" -s user', { stdio: "pipe" });
+        ok("Removed old registration");
+    }
+    catch {
+        // Not registered yet — fine
+    }
+}
+function register(token, backendUrl) {
+    execSync(`claude mcp add "localization" -s user -e MCP_TOKEN=${token} -e BACKEND_URL=${backendUrl} -- npx -y localization-mcp-server`, { stdio: "pipe" });
+}
+async function verifyToken(token, backendUrl) {
+    try {
+        const response = await fetch(`${backendUrl}/translations/projects`, {
+            headers: { Authorization: `Bearer ${token}` },
+            signal: AbortSignal.timeout(10_000),
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runSetup(args) {
+    console.log(`\n${BOLD}Localization MCP — setup${RESET}\n`);
+    const { token, backendUrl = "http://localhost:8080" } = parseArgs(args);
+    if (!token) {
+        fail("Missing --token. Run the command generated by the admin panel.");
+        process.exit(1);
+    }
+    // 1. Check Claude CLI
+    if (!checkClaudeCli()) {
+        fail("Claude CLI not found. Install it from https://claude.ai/code");
+        process.exit(1);
+    }
+    ok("Claude CLI found");
+    // 2. Remove old registration
+    removeOldRegistration();
+    // 3. Register with correct token
+    try {
+        register(token, backendUrl);
+        ok("MCP server registered");
+    }
+    catch (e) {
+        fail(`Failed to register MCP server: ${e}`);
+        process.exit(1);
+    }
+    // 4. Verify token works
+    const valid = await verifyToken(token, backendUrl);
+    if (!valid) {
+        fail("Token verification failed — the token may be expired or the server is unreachable.");
+        warn("MCP is registered but will not work until the token is valid.");
+        warn("Re-run this command with a fresh token from the admin panel.");
+        process.exit(1);
+    }
+    ok("Token verified");
+    console.log(`\n${GREEN}${BOLD}Setup complete.${RESET}`);
+    console.log("Restart Claude for the changes to take effect.\n");
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localization-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for the localization system — controlled AI access to translations",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -1,4 +1,13 @@
 #!/usr/bin/env node
+
+const args = process.argv.slice(2);
+
+if (args[0] === "setup") {
+  const { runSetup } = await import("./setup.js");
+  await runSetup(args.slice(1));
+  process.exit(0);
+}
+
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server.js";
 

package/src/setup.ts

@@ -0,0 +1,100 @@
+import { execSync } from "child_process";
+
+const BOLD = "\x1b[1m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const RESET = "\x1b[0m";
+
+const ok = (msg: string) => console.log(`${GREEN}✓${RESET} ${msg}`);
+const fail = (msg: string) => console.error(`${RED}✗${RESET} ${msg}`);
+const warn = (msg: string) => console.log(`${YELLOW}!${RESET} ${msg}`);
+
+function parseArgs(args: string[]): { token?: string; backendUrl?: string } {
+  const tokenIdx = args.indexOf("--token");
+  const backendIdx = args.indexOf("--backend-url");
+  return {
+    token: tokenIdx !== -1 ? args[tokenIdx + 1] : undefined,
+    backendUrl: backendIdx !== -1 ? args[backendIdx + 1] : undefined,
+  };
+}
+
+function checkClaudeCli(): boolean {
+  try {
+    execSync("claude --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function removeOldRegistration(): void {
+  try {
+    execSync('claude mcp remove "localization" -s user', { stdio: "pipe" });
+    ok("Removed old registration");
+  } catch {
+    // Not registered yet — fine
+  }
+}
+
+function register(token: string, backendUrl: string): void {
+  execSync(
+    `claude mcp add "localization" -s user -e MCP_TOKEN=${token} -e BACKEND_URL=${backendUrl} -- npx -y localization-mcp-server`,
+    { stdio: "pipe" },
+  );
+}
+
+async function verifyToken(token: string, backendUrl: string): Promise<boolean> {
+  try {
+    const response = await fetch(`${backendUrl}/translations/projects`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(10_000),
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+
+export async function runSetup(args: string[]): Promise<void> {
+  console.log(`\n${BOLD}Localization MCP — setup${RESET}\n`);
+
+  const { token, backendUrl = "http://localhost:8080" } = parseArgs(args);
+
+  if (!token) {
+    fail("Missing --token. Run the command generated by the admin panel.");
+    process.exit(1);
+  }
+
+  // 1. Check Claude CLI
+  if (!checkClaudeCli()) {
+    fail("Claude CLI not found. Install it from https://claude.ai/code");
+    process.exit(1);
+  }
+  ok("Claude CLI found");
+
+  // 2. Remove old registration
+  removeOldRegistration();
+
+  // 3. Register with correct token
+  try {
+    register(token, backendUrl);
+    ok("MCP server registered");
+  } catch (e) {
+    fail(`Failed to register MCP server: ${e}`);
+    process.exit(1);
+  }
+
+  // 4. Verify token works
+  const valid = await verifyToken(token, backendUrl);
+  if (!valid) {
+    fail("Token verification failed — the token may be expired or the server is unreachable.");
+    warn("MCP is registered but will not work until the token is valid.");
+    warn("Re-run this command with a fresh token from the admin panel.");
+    process.exit(1);
+  }
+  ok("Token verified");
+
+  console.log(`\n${GREEN}${BOLD}Setup complete.${RESET}`);
+  console.log("Restart Claude for the changes to take effect.\n");
+}