telique-mcp 1.0.0 → 1.0.2

package/dist/index.js

@@ -1,14 +1,19 @@
 #!/usr/bin/env node
-import { loadConfig } from "./config.js";
+import { stdin } from "node:process";
 const subcommand = process.argv[2];
-if (subcommand === "setup") {
+// If run with "setup" arg, or directly in a terminal (not piped by an MCP client),
+// launch the interactive setup flow.
+const isInteractiveTerminal = subcommand !== "serve" && stdin.isTTY === true;
+if (subcommand === "setup" || isInteractiveTerminal) {
     const { runSetup } = await import("./setup.js");
     await runSetup();
 }
 else {
+    // MCP server mode — stdin is piped JSON-RPC from the MCP client
     const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
     const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
     const { TeliqueClient } = await import("./client.js");
+    const { loadConfig } = await import("./config.js");
     const { setAnonymousMode } = await import("./utils/formatting.js");
     const { registerRoutelinkTools } = await import("./tools/routelink.js");
     const { registerLrnTools } = await import("./tools/lrn.js");

package/dist/setup.js

@@ -1,5 +1,6 @@
 import { createInterface } from "node:readline/promises";
 import { mkdirSync, writeFileSync, existsSync, readFileSync } from "node:fs";
+import { execSync, execFileSync } from "node:child_process";
 import { stdin, stdout } from "node:process";
 import { CONFIG_DIR, CONFIG_FILE } from "./config.js";
 const REGISTER_URL = "https://telique.ringer.tel/register";
@@ -13,8 +14,8 @@ export async function runSetup() {
         console.log(`  Found existing API key: ${maskToken(existing)}`);
         const keep = await rl.question("  Keep this key? (Y/n): ");
         if (keep.toLowerCase() !== "n") {
-            console.log("\n  ✓ Keeping existing configuration.\n");
-            printMcpConfig(existing);
+            console.log("\n  ✓ Keeping existing configuration.");
+            await registerWithClients(rl, existing);
             rl.close();
             return;
         }
@@ -44,26 +45,154 @@ export async function runSetup() {
             }
             saveToken(trimmed);
             console.log(`  ✓ Token validated`);
-            console.log(`  ✓ Saved to ${CONFIG_FILE}\n`);
-            printMcpConfig(trimmed);
+            console.log(`  ✓ Saved to ${CONFIG_FILE}`);
+            await registerWithClients(rl, trimmed);
             break;
         }
         case "2": {
             console.log(`\n  Opening ${REGISTER_URL} ...\n`);
             await openBrowser(REGISTER_URL);
-            console.log("  After creating your account, run this command again with your API key.\n");
+            console.log("  After creating your account, run `telique-mcp setup` again.\n");
             break;
         }
         case "3":
         default: {
             console.log("\n  ✓ Skipped. Running in anonymous mode (10 ops/min).");
-            console.log(`  Get an API key anytime at ${REGISTER_URL}\n`);
-            printMcpConfig(null);
+            console.log(`  Get an API key anytime at ${REGISTER_URL}`);
+            await registerWithClients(rl, null);
             break;
         }
     }
     rl.close();
 }
+async function registerWithClients(rl, token) {
+    const clients = detectMcpClients();
+    if (clients.length === 0) {
+        console.log("\n  No supported MCP clients detected.\n");
+        printManualConfig(token);
+        return;
+    }
+    console.log("\n  Detected MCP clients:\n");
+    clients.forEach((c, i) => console.log(`  [${i + 1}] ${c.name}`));
+    console.log(`  [A] All of the above`);
+    console.log(`  [S] Skip — I'll configure manually`);
+    console.log();
+    const answer = await rl.question("  Register with which client? > ");
+    const trimmed = answer.trim().toUpperCase();
+    if (trimmed === "S") {
+        printManualConfig(token);
+        return;
+    }
+    const selected = trimmed === "A"
+        ? clients
+        : clients.filter((_, i) => trimmed === String(i + 1));
+    if (selected.length === 0) {
+        printManualConfig(token);
+        return;
+    }
+    for (const client of selected) {
+        const success = client.register(token);
+        if (success) {
+            console.log(`  ✓ Registered with ${client.name}`);
+        }
+        else {
+            console.log(`  ✗ Failed to register with ${client.name}`);
+        }
+    }
+    console.log("\n  Done! Restart your MCP client to load the Telique tools.\n");
+}
+function detectMcpClients() {
+    const clients = [];
+    // Claude Code
+    if (commandExists("claude")) {
+        clients.push({
+            name: "Claude Code",
+            register: (token) => registerClaudeCode(token),
+        });
+    }
+    // Claude Desktop
+    const claudeDesktopConfig = getClaudeDesktopConfigPath();
+    if (claudeDesktopConfig && existsSync(claudeDesktopConfig)) {
+        clients.push({
+            name: "Claude Desktop",
+            register: (token) => registerJsonConfig(claudeDesktopConfig, token),
+        });
+    }
+    return clients;
+}
+function registerClaudeCode(token) {
+    try {
+        // Remove existing entry first (ignore errors if not found)
+        try {
+            execSync("claude mcp remove -s user telique 2>/dev/null", {
+                stdio: "ignore",
+            });
+        }
+        catch {
+            // ignore
+        }
+        const args = ["mcp", "add", "-s", "user", "telique"];
+        if (token) {
+            args.push("-e", `TELIQUE_API_TOKEN=${token}`);
+        }
+        args.push("--", "npx", "-y", "telique-mcp");
+        execFileSync("claude", args, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function registerJsonConfig(configPath, token) {
+    try {
+        let config = {};
+        try {
+            config = JSON.parse(readFileSync(configPath, "utf-8"));
+        }
+        catch {
+            // start fresh
+        }
+        if (!config.mcpServers || typeof config.mcpServers !== "object") {
+            config.mcpServers = {};
+        }
+        const servers = config.mcpServers;
+        const entry = {
+            command: "npx",
+            args: ["-y", "telique-mcp"],
+        };
+        if (token) {
+            entry.env = { TELIQUE_API_TOKEN: token };
+        }
+        servers.telique = entry;
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getClaudeDesktopConfigPath() {
+    const home = process.env.HOME || process.env.USERPROFILE || "";
+    switch (process.platform) {
+        case "darwin":
+            return `${home}/Library/Application Support/Claude/claude_desktop_config.json`;
+        case "win32":
+            return `${process.env.APPDATA}/Claude/claude_desktop_config.json`;
+        case "linux":
+            return `${home}/.config/Claude/claude_desktop_config.json`;
+        default:
+            return null;
+    }
+}
+function commandExists(cmd) {
+    try {
+        execSync(`which ${cmd} 2>/dev/null`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function loadExistingToken() {
     try {
         const raw = readFileSync(CONFIG_FILE, "utf-8");
@@ -76,11 +205,11 @@ function loadExistingToken() {
 }
 function saveToken(token) {
     mkdirSync(CONFIG_DIR, { recursive: true });
-    const config = existsSync(CONFIG_FILE)
+    const existing = existsSync(CONFIG_FILE)
         ? JSON.parse(readFileSync(CONFIG_FILE, "utf-8"))
         : {};
-    config.apiToken = token;
-    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n");
+    existing.apiToken = token;
+    writeFileSync(CONFIG_FILE, JSON.stringify(existing, null, 2) + "\n");
 }
 async function validateToken(token) {
     try {
@@ -108,7 +237,7 @@ async function openBrowser(url) {
             : "xdg-open";
     exec(`${cmd} ${url}`);
 }
-function printMcpConfig(token) {
+function printManualConfig(token) {
     const env = {};
     if (token) {
         env.TELIQUE_API_TOKEN = token;
@@ -122,7 +251,7 @@ function printMcpConfig(token) {
             },
         },
     };
-    console.log("  Add this to your MCP client configuration:\n");
+    console.log("\n  Add this to your MCP client configuration:\n");
     console.log(JSON.stringify(config, null, 2)
         .split("\n")
         .map((line) => "  " + line)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telique-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for Telique telecom APIs (RouteLink, LRN, CNAM, LERG)",
   "type": "module",
   "main": "dist/index.js",
@@ -8,12 +8,14 @@
     "telique-mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "postinstall.js"
   ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
+    "postinstall": "node postinstall.js",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/postinstall.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+console.log(`
+┌─────────────────────────────────────────────────┐
+│                                                 │
+│   telique-mcp installed successfully!           │
+│                                                 │
+│   Get started:                                  │
+│     telique-mcp setup                           │
+│                                                 │
+│   Or use immediately in anonymous mode           │
+│   (10 ops/min) — no API key required.           │
+│                                                 │
+│   Docs: https://github.com/Ringer/telique-mcp   │
+│                                                 │
+└─────────────────────────────────────────────────┘
+`);