@ecubelabs/atlassian-mcp 1.4.0 → 1.5.0

package/dist/confluence-tools/get-template-by-id.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export const registerGetTemplateById = (server, confluenceService) => {
+    server.tool('get-template-by-id', 'Get a specific content template by its ID. Returns detailed template information including name, description, space, labels, and optionally the template body content.', {
+        contentTemplateId: z.string().describe('The ID of the content template to retrieve'),
+        expand: z
+            .array(z.enum(['body', 'body.storage', 'body.view']))
+            .optional()
+            .describe('Properties to expand in the response. Use "body" or "body.storage" to include template content in storage format.'),
+    }, async ({ contentTemplateId, expand }) => {
+        try {
+            const result = await confluenceService.getTemplateById(contentTemplateId, {
+                expand,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to retrieve template: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/get-templates.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export const registerGetTemplates = (server, confluenceService) => {
+    server.tool('get-templates', 'Get list of content templates from Confluence. Returns global templates if no spaceKey is provided, or space-specific templates when spaceKey is specified.', {
+        spaceKey: z
+            .string()
+            .optional()
+            .describe('The key of the space to retrieve templates from. If not specified, global templates will be returned.'),
+        start: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('The starting index of the returned templates (for pagination). Default: 0'),
+        limit: z
+            .number()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Maximum number of templates to return per page. Default: 25, Max: 100'),
+        expand: z
+            .array(z.enum(['body', 'body.storage', 'body.view']))
+            .optional()
+            .describe('Properties to expand in the response. Use "body" or "body.storage" to include template content.'),
+    }, async ({ spaceKey, start, limit, expand }) => {
+        try {
+            const result = await confluenceService.getTemplates({
+                spaceKey,
+                start,
+                limit,
+                expand,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to retrieve templates: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/index.js

@@ -12,6 +12,8 @@ export { registerGetSpaceById } from './get-space-by-id.js';
 export { registerFindSpaceByName } from './find-space-by-name.js';
 export { registerGetRecentlyUpdatedPages } from './get-recently-updated-pages.js';
 export { registerGetRecentlyCreatedPages } from './get-recently-created-pages.js';
+export { registerGetTemplates } from './get-templates.js';
+export { registerGetTemplateById } from './get-template-by-id.js';
 // Write tools
 export { registerCreatePage } from './create-page.js';
 export { registerUpdatePage } from './update-page.js';

package/dist/confluence-tools-register.js

@@ -1,5 +1,5 @@
 import { ConfluenceService } from './libs/confluence-client.js';
-import { registerGetPages, registerGetPagesForLabel, registerGetPageById, registerGetLabels, registerFindPagesByLabelName, registerFindLabelByName, registerGetPageChildren, registerGetPageChildrenTree, registerGetSpaces, registerGetSpaceById, registerFindSpaceByName, registerGetRecentlyUpdatedPages, registerGetRecentlyCreatedPages, registerCreatePage, registerUpdatePage, registerDeletePage, registerAddLabelsToPage, registerRemoveLabelFromPage, registerConfluenceStorageFormatHelp, } from './confluence-tools/index.js';
+import { registerGetPages, registerGetPagesForLabel, registerGetPageById, registerGetLabels, registerFindPagesByLabelName, registerFindLabelByName, registerGetPageChildren, registerGetPageChildrenTree, registerGetSpaces, registerGetSpaceById, registerFindSpaceByName, registerGetRecentlyUpdatedPages, registerGetRecentlyCreatedPages, registerGetTemplates, registerGetTemplateById, registerCreatePage, registerUpdatePage, registerDeletePage, registerAddLabelsToPage, registerRemoveLabelFromPage, registerConfluenceStorageFormatHelp, } from './confluence-tools/index.js';
 export const registerConfluenceTools = (server) => {
     // Initialize Confluence service
     const confluenceService = new ConfluenceService();
@@ -17,6 +17,8 @@ export const registerConfluenceTools = (server) => {
     registerFindSpaceByName(server, confluenceService);
     registerGetRecentlyUpdatedPages(server, confluenceService);
     registerGetRecentlyCreatedPages(server, confluenceService);
+    registerGetTemplates(server, confluenceService);
+    registerGetTemplateById(server, confluenceService);
     // Register write tools
     registerCreatePage(server, confluenceService);
     registerUpdatePage(server, confluenceService);

package/dist/libs/base-client.js

@@ -8,11 +8,13 @@ export class BaseApiService {
     config;
     serviceName;
     client;
+    v1Client; // v1 API용 클라이언트 (Confluence 전용)
     rateLimiter;
     constructor(config, serviceName) {
         this.config = config;
         this.serviceName = serviceName;
         this.client = this.setupAxiosClient();
+        this.v1Client = this.setupV1AxiosClient();
         this.rateLimiter = pLimit(5); // 동시 요청 5개 제한
         this.setupInterceptors();
         this.setupRetry();
@@ -37,6 +39,24 @@ export class BaseApiService {
             },
         });
     }
+    /**
+     * Confluence v1 REST API용 클라이언트 설정
+     * v1 API 엔드포인트: /wiki/rest/api/...
+     */
+    setupV1AxiosClient() {
+        const auth = Buffer.from(`${this.config.email}:${this.config.apiToken}`).toString('base64');
+        const baseURL = `${this.config.host}/wiki/rest/api`;
+        return axios.create({
+            baseURL,
+            headers: {
+                Authorization: `Basic ${auth}`,
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+            paramsSerializer: (params) => this.serializeConfluenceParams(params),
+        });
+    }
     serializeConfluenceParams(params) {
         const searchParams = new URLSearchParams();
         Object.entries(params).forEach(([key, value]) => {
@@ -69,9 +89,20 @@ export class BaseApiService {
         }, (error) => {
             return this.handleError(error);
         });
+        // v1Client에도 동일한 인터셉터 설정
+        this.v1Client.interceptors.request.use((config) => {
+            return config;
+        }, (error) => {
+            return Promise.reject(error);
+        });
+        this.v1Client.interceptors.response.use((response) => {
+            return response;
+        }, (error) => {
+            return this.handleError(error);
+        });
     }
     setupRetry() {
-        axiosRetry(this.client, {
+        const retryConfig = {
             retries: 3,
             retryDelay: axiosRetry.exponentialDelay,
             retryCondition: (error) => {
@@ -79,7 +110,9 @@ export class BaseApiService {
                     error.response?.status === 429 || // Rate limit
                     error.response?.status === 503); // Service unavailable
             },
-        });
+        };
+        axiosRetry(this.client, retryConfig);
+        axiosRetry(this.v1Client, retryConfig);
     }
     async handleError(error) {
         const { response } = error;

package/dist/libs/confluence-client.js

@@ -334,7 +334,7 @@ export class ConfluenceService extends BaseApiService {
      * 참고: 라벨 관리는 v1 API를 사용 (/wiki/rest/api/content)
      */
     async addLabelsToPage(pageId, labels) {
-        return this.makeRequest(() => this.client.post(`/wiki/rest/api/content/${pageId}/label`, labels, {
+        return this.makeRequest(() => this.v1Client.post(`/content/${pageId}/label`, labels, {
             headers: {
                 'Content-Type': 'application/json',
             },
@@ -349,6 +349,38 @@ export class ConfluenceService extends BaseApiService {
         const params = {
             name: labelName,
         };
-        return this.makeRequest(() => this.client.delete(`/wiki/rest/api/content/${pageId}/label`, { params }));
+        return this.makeRequest(() => this.v1Client.delete(`/content/${pageId}/label`, { params }));
+    }
+    /**
+     * 템플릿 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-template/#api-wiki-rest-api-template-page-get
+     * 참고: 템플릿 API는 v1 API를 사용 (/wiki/rest/api/template)
+     */
+    async getTemplates(options) {
+        const params = {};
+        if (options) {
+            const { spaceKey, start, limit, expand } = options;
+            if (spaceKey)
+                params.spaceKey = spaceKey;
+            if (start !== undefined)
+                params.start = start;
+            if (limit !== undefined)
+                params.limit = limit;
+            if (expand)
+                params.expand = expand.join(',');
+        }
+        return this.makeRequest(() => this.v1Client.get('/template/page', { params }));
+    }
+    /**
+     * 특정 템플릿 상세 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-template/#api-wiki-rest-api-template-contentTemplateId-get
+     * 참고: 템플릿 API는 v1 API를 사용 (/wiki/rest/api/template)
+     */
+    async getTemplateById(contentTemplateId, options) {
+        const params = {};
+        if (options?.expand) {
+            params.expand = options.expand.join(',');
+        }
+        return this.makeRequest(() => this.v1Client.get(`/template/page/${contentTemplateId}`, { params }));
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecubelabs/atlassian-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "bin": "./dist/index.js",
   "repository": {
     "url": "https://github.com/Ecube-Labs/skynet.git"