@thammarongg/jira-mcp 0.4.0 → 0.5.0

package/dist/uninstall.js

@@ -0,0 +1,140 @@
+import { AGENTS, hasAgentEntry, removeAgentConfig, resolveAgents } from "./agents.js";
+import { makePrompter } from "./prompt.js";
+function parseFlags(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--agents") {
+            const value = argv[++i];
+            if (value === undefined)
+                throw new Error("Missing value for --agents");
+            flags.agents = value;
+        }
+        else if (arg === "--yes") {
+            flags.yes = true;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            flags.help = true;
+        }
+        else {
+            throw new Error(`Unknown option: ${arg} (see --help)`);
+        }
+    }
+    return flags;
+}
+function printUsage() {
+    console.log(`jira-mcp uninstall — remove jira MCP entries
+
+Usage:
+  npx -y @thammarongg/jira-mcp uninstall
+  npx -y @thammarongg/jira-mcp uninstall --agents all --yes
+
+Options:
+  --agents <list>    Comma-separated agent ids or 'all'
+  --yes              Skip the confirmation prompt
+  -h, --help         Show this help
+`);
+}
+function configuredAgents() {
+    return AGENTS.filter((agent) => hasAgentEntry(agent));
+}
+function resolveConfigured(spec, configured) {
+    const norm = spec.trim().toLowerCase();
+    if (norm === "all" || norm === "a")
+        return [...configured];
+    const ids = norm.split(/[,\s]+/).filter(Boolean);
+    const selected = [];
+    for (const id of ids) {
+        const agent = /^\d+$/.test(id)
+            ? configured[Number(id) - 1]
+            : configured.find((candidate) => candidate.id === id);
+        if (!agent) {
+            throw new Error(`Unknown configured agent '${id}'. Valid: ${configured.map((candidate, index) => `${index + 1}/${candidate.id}`).join(", ")} or all`);
+        }
+        if (!selected.includes(agent))
+            selected.push(agent);
+    }
+    if (selected.length === 0)
+        throw new Error("No agents selected");
+    return selected;
+}
+async function promptSelection(p, configured) {
+    console.log("\njira-mcp uninstall — select agents to remove:\n");
+    console.log("  a) Select All");
+    configured.forEach((agent, index) => {
+        console.log(`  ${index + 1}) ${agent.label.padEnd(15)} ${agent.path}`);
+    });
+    for (;;) {
+        const answer = (await p.ask("\nChoice (e.g. 1,3 or a): ")).trim().toLowerCase();
+        if (answer === "" && p.closed)
+            throw new Error("No input received (stdin closed)");
+        try {
+            return resolveConfigured(answer, configured);
+        }
+        catch (err) {
+            if (p.closed)
+                throw err;
+            console.log(`  ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+export async function runUninstall(argv) {
+    const flags = parseFlags(argv);
+    if (flags.help) {
+        printUsage();
+        return;
+    }
+    const configured = configuredAgents();
+    if (configured.length === 0) {
+        console.error("No jira MCP entries found. Run install to configure an agent first.");
+        process.exitCode = 1;
+        return;
+    }
+    const p = !flags.yes ? makePrompter() : undefined;
+    try {
+        const selected = flags.agents
+            ? resolveAgents(flags.agents)
+            : flags.yes
+                ? [...configured]
+                : await promptSelection(p, configured);
+        console.log("\nWill remove the jira MCP server from:");
+        for (const agent of selected) {
+            if (hasAgentEntry(agent))
+                console.log(`  - ${agent.label.padEnd(15)} ${agent.path}`);
+            else
+                console.log(`  skip ${agent.label.padEnd(15)} ${agent.path} (no jira entry)`);
+        }
+        if (!flags.yes) {
+            const answer = (await p.ask("\nProceed? [y/N] ")).trim().toLowerCase();
+            if (answer !== "y" && answer !== "yes") {
+                console.log("Aborted.");
+                return;
+            }
+        }
+        let removed = 0;
+        let failed = false;
+        for (const agent of selected) {
+            try {
+                const result = removeAgentConfig(agent);
+                if (result === "removed") {
+                    removed++;
+                    console.log(`  ok  ${agent.label.padEnd(15)} ${agent.path} (removed)`);
+                }
+                else {
+                    console.log(`  skip ${agent.label.padEnd(15)} ${agent.path} (no jira entry)`);
+                }
+            }
+            catch (err) {
+                failed = true;
+                console.error(`  ERR ${agent.label.padEnd(15)} ${agent.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        if (removed === 0 || failed)
+            process.exitCode = 1;
+        if (removed > 0)
+            console.log("\nDone. Restart each agent to pick up the change.");
+    }
+    finally {
+        p?.close();
+    }
+}

package/dist/update.js

@@ -0,0 +1,71 @@
+import { AGENTS, hasAgentEntry, readAgentEnv, resolveAgents, writeAgentConfig } from "./agents.js";
+function parseFlags(argv) {
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--agents") {
+            const value = argv[++i];
+            if (value === undefined)
+                throw new Error("Missing value for --agents");
+            flags.agents = value;
+        }
+        else if (arg === "--yes") {
+            // Accepted for scripts that use the same non-interactive convention as install/uninstall.
+        }
+        else if (arg === "--help" || arg === "-h") {
+            flags.help = true;
+        }
+        else {
+            throw new Error(`Unknown option: ${arg} (see --help)`);
+        }
+    }
+    return flags;
+}
+function printUsage() {
+    console.log(`jira-mcp update — refresh existing jira MCP entries
+
+Usage:
+  npx -y @thammarongg/jira-mcp update [--agents <list>]
+
+Options:
+  --agents <list>    Comma-separated agent ids or 'all'
+  -h, --help         Show this help
+`);
+}
+export async function runUpdate(argv) {
+    const flags = parseFlags(argv);
+    if (flags.help) {
+        printUsage();
+        return;
+    }
+    const selected = flags.agents ? resolveAgents(flags.agents) : [...AGENTS];
+    let found = 0;
+    let failed = false;
+    for (const agent of selected) {
+        const env = readAgentEnv(agent);
+        if (!env) {
+            const reason = hasAgentEntry(agent) ? "no readable jira credentials" : "no jira entry";
+            console.log(`  skip ${agent.label.padEnd(15)} ${agent.path} (${reason})`);
+            continue;
+        }
+        found++;
+        try {
+            const result = writeAgentConfig(agent, env);
+            if (result === "skipped")
+                console.log(`  skip ${agent.label.padEnd(15)} ${agent.path}`);
+            else
+                console.log(`  ok  ${agent.label.padEnd(15)} ${agent.path} (${result})`);
+        }
+        catch (err) {
+            failed = true;
+            console.error(`  ERR ${agent.label.padEnd(15)} ${agent.path}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (found === 0) {
+        console.error("No jira MCP entries with credentials were found. Run install to configure an agent first.");
+        process.exitCode = 1;
+    }
+    else if (failed) {
+        process.exitCode = 1;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thammarongg/jira-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "MCP server exposing the Jira REST API (boards, sprints, issues, JQL, and a generic passthrough) for Jira Cloud and Data Center",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -33,6 +33,29 @@ Or non-interactive: `npx -y @thammarongg/jira-mcp install --agents all
   Security → API tokens)
 - DC: `JIRA_USERNAME` + `JIRA_API_TOKEN` (PAT) or `JIRA_PASSWORD` (app password)
 
+When a selected agent already has a `jira` entry, the interactive installer
+offers to reuse its base URL and account; `--yes` with no credential flags
+reuses those credentials without prompting.
+
+The CLI also supports these maintenance commands:
+
+```bash
+npx -y @thammarongg/jira-mcp update                 # refresh configured entries
+npx -y @thammarongg/jira-mcp update --agents codex
+npx -y @thammarongg/jira-mcp uninstall              # choose entries to remove
+npx -y @thammarongg/jira-mcp uninstall --agents all --yes
+npx -y @thammarongg/jira-mcp --version
+npx -y @thammarongg/jira-mcp --help
+```
+
+`update` is non-interactive and skips agents without a `jira` entry.
+`uninstall` preserves every other config key and confirms before removing the
+selected entries unless `--yes` is supplied. Running the command with no
+arguments in a terminal shows a status card; MCP clients use piped stdio, so
+the same command starts the server and expects `JIRA_*` environment variables.
+Without those variables, a bare server start reports a missing
+`JIRA_BASE_URL`.
+
 Claude Code one-liner:
 
 ```bash