@stubbedev/atlassian-mcp 0.3.5 → 0.3.6

package/README.md

@@ -67,6 +67,8 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 - "list releases for PAY" → `jira_search` with `resource=versions`, `project=PAY`
 - "release version 12345" → `jira_version` with `action=release`, `id=12345`
 - "set fix version 9.1.0 on FOO-123" → `jira_mutate` with `update.fixVersion=9.1.0`
+- "create a task under epic FOO-100" → `jira_mutate` with `create.issueType=Task`, `create.parent=FOO-100` (auto-detects Epic and sets Epic Link)
+- "move FOO-123 under epic FOO-100" → `jira_mutate` with `update.epicLink=FOO-100`
 
 ---
 

package/dist/index.js

@@ -261,7 +261,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                                 priority: { type: 'string', description: 'Priority name (optional)' },
                                 labels: { type: 'array', items: { type: 'string' }, description: 'Labels to apply (optional)' },
                                 fixVersion: { type: 'string', description: 'Fix version name (optional)' },
-                                parent: { type: 'string', description: 'Parent issue key for subtasks (optional)' },
+                                parent: { type: 'string', description: 'Parent issue key. For Sub-task issue types this sets the Jira parent. If the key points to an Epic, the Epic Link custom field is set automatically instead (Jira Server epic membership).' },
+                                epicLink: { type: 'string', description: 'Epic issue key to attach the new issue to as an epic child (Jira Server Epic Link). Overrides parent if both are passed.' },
                             },
                             required: ['issueType', 'summary'],
                         },
@@ -274,6 +275,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                                 priority: { type: 'string', description: 'New priority name (optional)' },
                                 labels: { type: 'array', items: { type: 'string' }, description: 'Replace label set (pass [] to clear)' },
                                 fixVersion: { type: 'string', description: 'Fix version name, or empty string to clear (optional)' },
+                                epicLink: { type: 'string', description: 'Epic issue key to set as parent epic (Jira Server Epic Link), or empty string to clear.' },
                             },
                         },
                         sprintId: { type: 'number', description: 'Sprint ID to add the issue into (optional)' },

package/dist/jira.js

@@ -97,6 +97,8 @@ export class JiraClient {
     currentUserCache;
     projectsCache;
     issueLinkingEnabled;
+    epicLinkFieldIdCache;
+    issueTypeCache = new Map();
     constructor(baseUrl, token) {
         this.baseUrl = baseUrl.replace(/\/$/, '');
         this.headers = {
@@ -128,7 +130,17 @@ export class JiraClient {
             const details = parseJiraErrorDetails(errText);
             throw new Error(formatJiraError(res.status, method, path, details));
         }
-        return res.status === 204 ? null : res.json();
+        if (res.status === 204)
+            return null;
+        const raw = await res.text();
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
     }
     async request(method, path, body) {
         return this.requestWithBase('/rest/api/2', method, path, body);
@@ -159,6 +171,24 @@ export class JiraClient {
         this.issueLinkingEnabled = config?.issueLinkingEnabled ?? false;
         return this.issueLinkingEnabled;
     }
+    async getEpicLinkFieldId() {
+        if (this.epicLinkFieldIdCache !== undefined)
+            return this.epicLinkFieldIdCache;
+        const fields = (await this.request('GET', '/field')) ?? [];
+        const match = fields.find((f) => f.schema?.custom === 'com.pyxis.greenhopper.jira:gh-epic-link');
+        this.epicLinkFieldIdCache = match?.id ?? null;
+        return this.epicLinkFieldIdCache;
+    }
+    async getIssueType(issueKey) {
+        const cached = this.issueTypeCache.get(issueKey);
+        if (cached)
+            return cached;
+        const data = await this.request('GET', `/issue/${encodeURIComponent(issueKey)}?fields=issuetype`);
+        const name = data?.fields?.issuetype?.name ?? null;
+        if (name)
+            this.issueTypeCache.set(issueKey, name);
+        return name;
+    }
     async assertOwnComment(comment) {
         const me = await this.getCurrentUser();
         const commentAuthorName = this.normalizeIdentity(comment.author.name);
@@ -200,8 +230,23 @@ export class JiraClient {
             fields.labels = args.labels;
         if (args.fixVersion)
             fields.fixVersions = [{ name: args.fixVersion }];
-        if (args.parent)
-            fields.parent = { key: args.parent };
+        let epicLinkTarget = args.epicLink?.trim() || undefined;
+        if (args.parent) {
+            const parentType = await this.getIssueType(args.parent);
+            if (parentType === 'Epic') {
+                epicLinkTarget = epicLinkTarget ?? args.parent;
+            }
+            else {
+                fields.parent = { key: args.parent };
+            }
+        }
+        if (epicLinkTarget) {
+            const epicFieldId = await this.getEpicLinkFieldId();
+            if (!epicFieldId) {
+                throw new Error('Epic Link custom field not found on this Jira instance. Set it manually in the Jira UI.');
+            }
+            fields[epicFieldId] = epicLinkTarget;
+        }
         return this.request('POST', '/issue', { fields });
     }
     async updateIssueFieldsInternal(args) {
@@ -218,6 +263,13 @@ export class JiraClient {
             fields.labels = args.labels;
         if (args.fixVersion !== undefined)
             fields.fixVersions = args.fixVersion ? [{ name: args.fixVersion }] : [];
+        if (args.epicLink !== undefined) {
+            const epicFieldId = await this.getEpicLinkFieldId();
+            if (!epicFieldId) {
+                throw new Error('Epic Link custom field not found on this Jira instance. Set it manually in the Jira UI.');
+            }
+            fields[epicFieldId] = args.epicLink ? args.epicLink : null;
+        }
         if (Object.keys(fields).length === 0)
             return false;
         await this.request('PUT', `/issue/${encodeURIComponent(args.issueKey)}`, { fields });
@@ -401,11 +453,16 @@ export class JiraClient {
         const includeSprint = args.includeSprint ?? true;
         const commentsMaxResults = args.commentsMaxResults ?? 10;
         const commentsStartAt = args.commentsStartAt ?? 0;
-        const fields = 'summary,description,status,assignee,priority,issuetype,labels,components,parent,fixVersions,issuelinks,subtasks,attachment';
+        const baseFields = 'summary,description,status,assignee,priority,issuetype,labels,components,parent,fixVersions,issuelinks,subtasks,attachment';
+        const epicFieldId = await this.getEpicLinkFieldId();
+        const fields = epicFieldId ? `${baseFields},${epicFieldId}` : baseFields;
         const issue = await this.request('GET', `/issue/${encodeURIComponent(args.issueKey)}?fields=${fields}`);
         if (!issue)
             return text('Issue not found.');
         const f = issue.fields;
+        const epicLinkKey = epicFieldId && typeof f[epicFieldId] === 'string'
+            ? f[epicFieldId]
+            : undefined;
         const lines = [
             `Issue: ${issue.key} — ${f.summary}`,
             `URL:        ${this.issueUrl(issue.key)}`,
@@ -416,6 +473,7 @@ export class JiraClient {
             `Labels:     ${f.labels?.join(', ') || 'None'}`,
             `Components: ${f.components?.map((c) => c.name).join(', ') || 'None'}`,
             ...(f.parent ? [`Parent:     [${f.parent.key}] ${f.parent.fields.summary} (${f.parent.fields.issuetype.name})`] : []),
+            ...(epicLinkKey ? [`Epic Link:  ${epicLinkKey}`] : []),
             ...(f.fixVersions?.length ? [`Fix Vers:   ${f.fixVersions.map((v) => v.name).join(', ')}`] : []),
             ...(f.subtasks?.length ? [`Subtasks:   ${f.subtasks.map((s) => `[${s.key}] ${s.fields.summary} (${s.fields.status.name})`).join(', ')}`] : []),
             ...(f.issuelinks?.length ? [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "license": "MIT",
   "type": "module",