@stubbedev/atlassian-mcp 0.0.5 → 0.1.0

package/dist/jira.js

@@ -1,3 +1,5 @@
+import { execSync } from 'child_process';
+const JIRA_KEY_IN_BRANCH_RE = /\b([A-Z][A-Z0-9]+)-\d+\b/;
 function text(t) {
     return { content: [{ type: 'text', text: t }] };
 }
@@ -23,6 +25,57 @@ function buildJQL(args) {
         throw new Error('Provide at least one of: query, jql, project, status, assignee, issueType');
     return clauses.join(' AND ') + ' ORDER BY updated DESC';
 }
+function safeExec(cmd) {
+    try {
+        return execSync(cmd, { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+function parseJiraErrorDetails(errText) {
+    const trimmed = errText.trim();
+    if (!trimmed)
+        return '';
+    try {
+        const parsed = JSON.parse(trimmed);
+        const parts = [];
+        if (Array.isArray(parsed.errorMessages)) {
+            for (const msg of parsed.errorMessages) {
+                const clean = (msg ?? '').trim();
+                if (clean)
+                    parts.push(clean);
+            }
+        }
+        if (parsed.errors && typeof parsed.errors === 'object') {
+            for (const [field, msg] of Object.entries(parsed.errors)) {
+                const clean = (msg ?? '').trim();
+                if (clean)
+                    parts.push(`${field}: ${clean}`);
+            }
+        }
+        if (parts.length > 0)
+            return parts.join(' | ');
+    }
+    catch {
+        // Fallback to raw text below
+    }
+    return trimmed.length > 500 ? `${trimmed.slice(0, 500)}...` : trimmed;
+}
+function formatJiraError(status, method, path, details) {
+    const prefix = `Jira ${status} ${method} ${path}`;
+    if (status === 400)
+        return `${prefix}. Invalid request or parameters. ${details}`.trim();
+    if (status === 401)
+        return `${prefix}. Authentication failed. Check JIRA_ACCESS_TOKEN.`;
+    if (status === 403)
+        return `${prefix}. Permission denied. Check Jira permissions for this token.`;
+    if (status === 404)
+        return `${prefix}. Resource not found. Verify issue/project identifiers and access.`;
+    if (status === 409)
+        return `${prefix}. Conflict. Refresh and retry. ${details}`.trim();
+    return details ? `${prefix}. ${details}` : prefix;
+}
 export class JiraClient {
     baseUrl;
     headers;
@@ -42,10 +95,33 @@ export class JiraClient {
         const res = await fetch(url, opts);
         if (!res.ok) {
             const errText = await res.text();
-            throw new Error(`Jira ${res.status} ${method} ${path}: ${errText}`);
+            const details = parseJiraErrorDetails(errText);
+            throw new Error(formatJiraError(res.status, method, path, details));
         }
         return res.status === 204 ? null : res.json();
     }
+    async resolveProjectKey(projectKey) {
+        if (projectKey)
+            return projectKey;
+        const projects = (await this.request('GET', '/project?maxResults=100')) ?? [];
+        if (projects.length === 0) {
+            throw new Error('No Jira projects found for your account.');
+        }
+        const keys = new Set(projects.map((p) => p.key));
+        const branch = safeExec('git rev-parse --abbrev-ref HEAD');
+        const branchMatch = branch.match(JIRA_KEY_IN_BRANCH_RE);
+        const branchProjectKey = branchMatch?.[1];
+        if (branchProjectKey && keys.has(branchProjectKey)) {
+            return branchProjectKey;
+        }
+        if (projects.length === 1) {
+            return projects[0].key;
+        }
+        const shown = projects.slice(0, 20);
+        const lines = shown.map((p, i) => `${i + 1}. ${p.key} — ${p.name}`);
+        const extra = projects.length > shown.length ? `\n...and ${projects.length - shown.length} more.` : '';
+        throw new Error(`Please provide projectKey (or project) for this Jira action. Choose one of these project codes:\n${lines.join('\n')}${extra}`);
+    }
     async searchIssues(args) {
         const { maxResults = 20, startAt = 0 } = args;
         const jql = buildJQL(args);
@@ -81,7 +157,7 @@ export class JiraClient {
         return text(`${data.length} project(s):\n${lines.join('\n')}`);
     }
     async getIssueTypes(args) {
-        const { projectKey } = args;
+        const projectKey = await this.resolveProjectKey(args.projectKey);
         const data = await this.request('GET', `/project/${projectKey}/statuses`);
         if (!data || data.length === 0)
             return text('No issue types found.');
@@ -125,7 +201,7 @@ export class JiraClient {
         return text(lines.join('\n'));
     }
     async createIssue(args) {
-        const { projectKey } = args;
+        const projectKey = await this.resolveProjectKey(args.projectKey);
         const fields = {
             project: { key: projectKey },
             issuetype: { name: args.issueType },
@@ -173,17 +249,26 @@ export class JiraClient {
         await this.request('POST', `/issue/${args.issueKey}/comment`, { body: args.body });
         return text(`Comment added to ${args.issueKey}.`);
     }
-    async getTransitions(args) {
-        const data = await this.request('GET', `/issue/${args.issueKey}/transitions`);
-        if (!data || data.transitions.length === 0)
-            return text('No transitions available.');
-        const lines = data.transitions.map((t) => `${t.id}: ${t.name} → ${t.to.name}`);
-        return text(`Available transitions for ${args.issueKey}:\n${lines.join('\n')}`);
-    }
     async transitionIssue(args) {
+        let transitionId = args.transitionId;
+        if (!transitionId) {
+            const requestedName = args.transitionName?.trim();
+            if (!requestedName) {
+                throw new Error('Provide transitionId or transitionName');
+            }
+            const data = await this.request('GET', `/issue/${args.issueKey}/transitions`);
+            const transitions = data?.transitions ?? [];
+            const lowered = requestedName.toLowerCase();
+            const match = transitions.find((t) => t.name.toLowerCase() === lowered);
+            if (!match) {
+                const available = transitions.map((t) => t.name).join(', ') || '(none)';
+                throw new Error(`Transition "${requestedName}" not found for ${args.issueKey}. Available: ${available}`);
+            }
+            transitionId = match.id;
+        }
         await this.request('POST', `/issue/${args.issueKey}/transitions`, {
-            transition: { id: args.transitionId },
+            transition: { id: transitionId },
         });
-        return text(`Transitioned ${args.issueKey} using transition ${args.transitionId}.`);
+        return text(`Transitioned ${args.issueKey} using transition ${transitionId}.`);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,9 @@
     "prepare": "tsc",
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "smoke": "npm run build && npm run smoke:tools",
+    "smoke:tools": "printf '%s\\n' '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' | node dist/index.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",