@ecubelabs/atlassian-mcp 1.14.1 → 1.15.2

package/dist/jira-tools-register.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { JiraService } from './libs/jira-client.js';
-import { formatToolResponse } from './libs/response-formatter.js';
+import { formatToolResponse, saveBinaryToTempFile } from './libs/response-formatter.js';
 export const registerJiraTools = (server) => {
     // Initialize Jira service
     const jiraService = new JiraService();
@@ -23,9 +23,15 @@ export const registerJiraTools = (server) => {
     }, async ({ issueKey, expand }) => {
         try {
             const issue = await jiraService.getIssue(issueKey, expand);
+            const attachments = (issue.fields?.attachment ?? []);
+            const attachmentSummary = attachments.length > 0
+                ? ` | ${attachments.length} attachment(s): ${attachments
+                    .map((a) => `${a.filename} (id: ${a.id})`)
+                    .join(', ')}. Use the download-attachment tool to fetch them.`
+                : '';
             return formatToolResponse(issue, {
                 toolName: 'get-issue',
-                summary: `Issue ${issue.key}: ${issue.fields?.summary ?? ''} (Status: ${issue.fields?.status?.name ?? 'unknown'})`,
+                summary: `Issue ${issue.key}: ${issue.fields?.summary ?? ''} (Status: ${issue.fields?.status?.name ?? 'unknown'})${attachmentSummary}`,
             });
         }
         catch (error) {
@@ -39,6 +45,65 @@ export const registerJiraTools = (server) => {
             };
         }
     });
+    server.tool('download-attachment', 'Download a file attached to a Jira issue and save it to a local temp file, returning the file path. ' +
+        'The file can then be opened with the Read tool. Identify the attachment either by its attachmentId ' +
+        '(found in an issue\'s "attachment" field via get-issue) or by issueKey + filename.', {
+        attachmentId: z
+            .string()
+            .optional()
+            .describe('Attachment ID (from the issue\'s "attachment" field). Takes precedence over filename.'),
+        issueKey: z
+            .string()
+            .optional()
+            .describe('Jira issue key (e.g. PROJ-123). Required when resolving the attachment by filename.'),
+        filename: z
+            .string()
+            .optional()
+            .describe('Attachment filename to look up within the issue. Used together with issueKey.'),
+    }, async ({ attachmentId, issueKey, filename }) => {
+        try {
+            let resolvedId = attachmentId;
+            let resolvedFilename;
+            // Resolve attachment id by issueKey + filename when id is not provided
+            if (!resolvedId) {
+                if (!issueKey || !filename) {
+                    throw new Error('Provide either attachmentId, or both issueKey and filename');
+                }
+                const issue = await jiraService.getIssue(issueKey);
+                const attachments = (issue.fields?.attachment ?? []);
+                const match = attachments.find((a) => a.filename === filename);
+                if (!match) {
+                    const available = attachments.map((a) => a.filename).join(', ') || '(none)';
+                    throw new Error(`No attachment named "${filename}" found on ${issueKey}. Available: ${available}`);
+                }
+                resolvedId = match.id;
+                resolvedFilename = match.filename;
+            }
+            // Fetch metadata to get the original filename / mimeType / size
+            const metadata = await jiraService.getAttachmentMetadata(resolvedId);
+            resolvedFilename = resolvedFilename ?? metadata.filename ?? `attachment-${resolvedId}`;
+            const data = await jiraService.downloadAttachment(resolvedId);
+            const filePath = saveBinaryToTempFile(data, resolvedFilename);
+            const message = [
+                `Downloaded attachment "${resolvedFilename}" (id: ${resolvedId}, ${metadata.mimeType ?? 'unknown type'}, ${data.length.toLocaleString()} bytes).`,
+                ``,
+                `File: ${filePath}`,
+                ``,
+                `Use the Read tool to open this file.`,
+            ].join('\n');
+            return { content: [{ type: 'text', text: message }] };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to download attachment: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
     server.tool('search-issues', 'Search Jira issues using JQL', {
         jql: z.string().describe('JQL query string. Must be a bounded query with search restrictions.'),
         fields: z

package/dist/libs/jira-client.js

@@ -14,6 +14,29 @@ export class JiraService extends BaseApiService {
             params: expand ? { expand: expand.join(',') } : undefined,
         }));
     }
+    /**
+     * 첨부파일 메타데이터 조회 (파일명, mimeType, 크기, 다운로드 URL 등)
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/#api-rest-api-3-attachment-id-get
+     */
+    async getAttachmentMetadata(attachmentId) {
+        return this.makeRequest(() => this.client.get(`/attachment/${attachmentId}`));
+    }
+    /**
+     * 첨부파일 바이너리 콘텐츠 다운로드
+     *
+     * `redirect=false` 로 요청하여 미디어 서비스로의 cross-host 리다이렉트 없이
+     * 바이너리를 직접(200 OK) 받는다. 이렇게 하면 Basic 인증 헤더가 외부 호스트로
+     * 전달되며 발생할 수 있는 인증 문제를 피할 수 있다.
+     * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/#api-rest-api-3-attachment-content-id-get
+     */
+    async downloadAttachment(attachmentId) {
+        const data = await this.makeRequest(() => this.client.get(`/attachment/content/${attachmentId}`, {
+            params: { redirect: false },
+            responseType: 'arraybuffer',
+            headers: { Accept: '*/*' },
+        }));
+        return Buffer.from(data);
+    }
     /**
      * JQL 검색 (Enhanced Search)
      * @see https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-post

package/dist/libs/response-formatter.js

@@ -57,10 +57,23 @@ export function formatToolResponse(data, options) {
         .join('\n');
     return { content: [{ type: 'text', text: message }] };
 }
+/**
+ * 바이너리 데이터(첨부파일 등)를 temp 디렉터리에 저장하고 경로를 반환한다.
+ * MCP 응답은 텍스트 채널이므로 바이너리는 파일로 저장한 뒤 경로를 돌려주어
+ * 에이전트가 Read 도구로 읽도록 한다.
+ */
+export function saveBinaryToTempFile(data, originalFilename) {
+    const tempDir = getTempDir();
+    const safeName = originalFilename.replace(/[^a-zA-Z0-9._-]/g, '_') || 'attachment';
+    const fileName = `atlassian-mcp-attachment-${Date.now()}-${randomUUID().slice(0, 8)}-${safeName}`;
+    const filePath = join(tempDir, fileName);
+    writeFileSync(filePath, data);
+    return filePath;
+}
 export function cleanupOldTempFiles() {
     try {
         const dir = getTempDir();
-        const files = readdirSync(dir).filter((f) => f.startsWith('atlassian-mcp-') && f.endsWith('.json'));
+        const files = readdirSync(dir).filter((f) => f.startsWith('atlassian-mcp-') && (f.endsWith('.json') || f.startsWith('atlassian-mcp-attachment-')));
         const now = Date.now();
         for (const file of files) {
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecubelabs/atlassian-mcp",
-  "version": "1.14.1",
+  "version": "1.15.2",
   "bin": "./dist/index.js",
   "repository": {
     "url": "https://github.com/Ecube-Labs/skynet.git"
@@ -28,7 +28,7 @@
     "marklassian": "^1.1.0",
     "p-limit": "^5.0.0",
     "winston": "^3.17.0",
-    "zod": "^3.24.2"
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.8",