@ecubelabs/atlassian-mcp 1.15.3-next.1 → 1.16.0

package/dist/jira-tools-register.js

@@ -1,6 +1,15 @@
 import { z } from 'zod';
 import { JiraService } from './libs/jira-client.js';
 import { formatToolResponse, saveBinaryToTempFile } from './libs/response-formatter.js';
+const toDefaultAssignee = (user) => user
+    ? {
+        accountId: user.accountId,
+        displayName: user.displayName,
+        emailAddress: user.emailAddress,
+        active: user.active,
+    }
+    : null;
+const describeDefaultAssignee = (assignee, assigneeType) => assignee ? `${assignee.displayName} (${assignee.accountId})` : `none (assigneeType: ${assigneeType ?? 'unknown'})`;
 export const registerJiraTools = (server) => {
     // Initialize Jira service
     const jiraService = new JiraService();
@@ -318,6 +327,76 @@ export const registerJiraTools = (server) => {
             };
         }
     });
+    server.tool('get-project', 'Get a single Jira project, including its default assignee configuration. ' +
+        'Unlike get-projects (which uses the project search endpoint and omits it), this returns "assigneeType". ' +
+        'The "defaultAssignee" field is derived by this tool: the project lead when assigneeType is PROJECT_LEAD, ' +
+        'and null when it is UNASSIGNED. For component-level defaults use get-project-components.', {
+        projectIdOrKey: z.string().describe('Project ID or key (e.g. PROJ or 10001)'),
+        expand: z
+            .array(z.enum(['description', 'issueTypes', 'lead', 'projectKeys', 'issueTypeHierarchy']))
+            .optional()
+            .describe('Additional fields to include: description, issueTypes, lead, projectKeys, issueTypeHierarchy'),
+        properties: z.array(z.string()).optional().describe('Project property keys to include in the response'),
+    }, async ({ projectIdOrKey, expand, properties }) => {
+        try {
+            const project = await jiraService.getProject(projectIdOrKey, { expand, properties });
+            const defaultAssignee = project.assigneeType === 'PROJECT_LEAD' ? toDefaultAssignee(project.lead) : null;
+            return formatToolResponse({ ...project, defaultAssignee }, {
+                toolName: 'get-project',
+                summary: `Project ${project.key}: ${project.name} | Default assignee: ${describeDefaultAssignee(defaultAssignee, project.assigneeType)}`,
+            });
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to retrieve project: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.tool('get-project-components', 'Get the components of a Jira project together with their default assignee. Each entry exposes a ' +
+        '"defaultAssignee" derived from Jira\'s realAssignee, which already resolves PROJECT_DEFAULT down to the ' +
+        'project-level setting; isAssigneeTypeValid is false when the configured assigneeType cannot be applied. ' +
+        'Set includeRaw to true to get the full unmodified API objects instead of the slim view.', {
+        projectIdOrKey: z.string().describe('Project ID or key (e.g. PROJ or 10001)'),
+        includeRaw: z
+            .boolean()
+            .optional()
+            .describe('Return the full component objects from the API instead of the slim default-assignee view. Default: false'),
+    }, async ({ projectIdOrKey, includeRaw }) => {
+        try {
+            const components = await jiraService.getProjectComponents(projectIdOrKey);
+            const invalidCount = components.filter((component) => component.isAssigneeTypeValid === false).length;
+            const summary = `${components.length} component(s) in ${projectIdOrKey}` +
+                (invalidCount > 0 ? ` | ${invalidCount} with an invalid assigneeType` : '');
+            if (includeRaw) {
+                return formatToolResponse(components, { toolName: 'get-project-components', summary });
+            }
+            const slimComponents = components.map((component) => ({
+                id: component.id,
+                name: component.name,
+                description: component.description,
+                assigneeType: component.assigneeType,
+                realAssigneeType: component.realAssigneeType,
+                isAssigneeTypeValid: component.isAssigneeTypeValid,
+                defaultAssignee: toDefaultAssignee(component.realAssignee),
+            }));
+            return formatToolResponse(slimComponents, { toolName: 'get-project-components', summary });
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to retrieve project components: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
     server.tool('get-create-metadata-issue-types', 'Get issue types available for creating issues in a project', {
         projectIdOrKey: z.string().describe('Project ID (numeric) or project key (e.g. PROJ)'),
     }, async ({ projectIdOrKey }) => {

package/dist/libs/jira-client.js

@@ -114,6 +114,25 @@ export class JiraService extends BaseApiService {
         }
         return this.makeRequest(() => this.client.get('/project/search', { params }));
     }
+    /**
+     * 프로젝트 단건 조회 (기본 담당자 설정인 assigneeType, lead 포함)
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-projectidorkey-get
+     */
+    async getProject(projectIdOrKey, options) {
+        const params = {};
+        if (options?.expand)
+            params.expand = options.expand.join(',');
+        if (options?.properties)
+            params.properties = options.properties.join(',');
+        return this.makeRequest(() => this.client.get(`/project/${projectIdOrKey}`, { params }));
+    }
+    /**
+     * 프로젝트 컴포넌트 목록 조회 (컴포넌트별 기본 담당자인 realAssignee 포함)
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-project-components/#api-rest-api-3-project-projectidorkey-components-get
+     */
+    async getProjectComponents(projectIdOrKey) {
+        return this.makeRequest(() => this.client.get(`/project/${projectIdOrKey}/components`));
+    }
     /**
      * 이슈 댓글 목록 조회
      * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-get

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecubelabs/atlassian-mcp",
-  "version": "1.15.3-next.1",
+  "version": "1.16.0",
   "bin": "./dist/index.js",
   "repository": {
     "url": "https://github.com/Ecube-Labs/skynet.git"
@@ -38,6 +38,5 @@
     "semantic-release-yarn": "^3.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
-  },
-  "stableVersion": "1.0.0"
+  }
 }