@ecubelabs/atlassian-mcp 1.6.0 → 1.8.0

package/dist/confluence-tools/create-folder.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export const registerCreateFolder = (server, confluenceService) => {
+    server.tool('create-folder', 'Create a new folder in a Confluence space. Folders can contain pages and other folders.', {
+        spaceId: z.string().describe('ID of the space where the folder will be created'),
+        title: z.string().describe('Title of the folder'),
+        parentId: z
+            .string()
+            .optional()
+            .describe('ID of the parent folder. If not provided, the folder will be created at the space root.'),
+    }, async ({ spaceId, title, parentId }) => {
+        try {
+            const result = await confluenceService.createFolder({
+                spaceId,
+                title,
+                parentId,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to create folder: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/delete-folder.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const registerDeleteFolder = (server, confluenceService) => {
+    server.tool('delete-folder', 'Delete a Confluence folder. The folder will be moved to trash where it can be restored later.', {
+        folderId: z.string().describe('ID of the folder to delete'),
+    }, async ({ folderId }) => {
+        try {
+            await confluenceService.deleteFolder(folderId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, message: `Folder ${folderId} has been deleted (moved to trash)` }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to delete folder: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const registerGetFolderById = (server, confluenceService) => {
+    server.tool('get-folder-by-id', 'Get details of a specific Confluence folder by its ID.', {
+        folderId: z.string().describe('ID of the folder to retrieve'),
+    }, async ({ folderId }) => {
+        try {
+            const result = await confluenceService.getFolderById(folderId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get folder: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/get-folder-children.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+export const registerGetFolderChildren = (server, confluenceService) => {
+    server.tool('get-folder-children', 'Get direct children (pages, folders, etc.) of a Confluence folder. Use type filter to retrieve only specific content types.', {
+        folderId: z.string().describe('ID of the folder'),
+        type: z
+            .enum(['page', 'folder', 'whiteboard', 'database', 'embed'])
+            .optional()
+            .describe('Filter by content type (page, folder, whiteboard, database, embed)'),
+        cursor: z.string().optional().describe('Cursor for pagination'),
+        limit: z
+            .number()
+            .min(1)
+            .max(250)
+            .optional()
+            .describe('Maximum number of results to return (default: 25, max: 250)'),
+        sort: z
+            .enum([
+            'id',
+            '-id',
+            'created-date',
+            '-created-date',
+            'modified-date',
+            '-modified-date',
+            'title',
+            '-title',
+        ])
+            .optional()
+            .describe('Sort order for results'),
+    }, async ({ folderId, type, cursor, limit, sort }) => {
+        try {
+            const result = await confluenceService.getFolderChildren(folderId, {
+                cursor,
+                limit,
+                sort,
+            });
+            // Apply client-side type filter if specified
+            let filteredResults = result.results;
+            if (type) {
+                filteredResults = result.results.filter((child) => child.type === type);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            ...result,
+                            results: filteredResults,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get folder children: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/get-page-children.js

@@ -1,7 +1,11 @@
 import { z } from 'zod';
 export const registerGetPageChildren = (server, confluenceService) => {
-    server.tool('get-page-children', 'Get direct child pages of a specific page', {
+    server.tool('get-page-children', 'Get direct children (pages, folders, etc.) of a specific page. Use type filter to retrieve only specific content types.', {
         pageId: z.string().describe('ID of the parent page'),
+        type: z
+            .enum(['page', 'folder', 'whiteboard', 'database', 'embed'])
+            .optional()
+            .describe('Filter by content type (page, folder, whiteboard, database, embed)'),
         cursor: z.string().optional().describe('Cursor for pagination'),
         limit: z
             .number()
@@ -22,18 +26,26 @@ export const registerGetPageChildren = (server, confluenceService) => {
         ])
             .optional()
             .describe('Sort order for results'),
-    }, async ({ pageId, cursor, limit, sort }) => {
+    }, async ({ pageId, type, cursor, limit, sort }) => {
         try {
             const result = await confluenceService.getPageChildren(pageId, {
                 cursor,
                 limit,
                 sort,
             });
+            // Apply client-side type filter if specified
+            let filteredResults = result.results;
+            if (type) {
+                filteredResults = result.results.filter((child) => child.type === type);
+            }
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify(result),
+                        text: JSON.stringify({
+                            ...result,
+                            results: filteredResults,
+                        }),
                     },
                 ],
             };

package/dist/confluence-tools/get-page-descendants.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export const registerGetPageDescendants = (server, confluenceService) => {
+    server.tool('get-page-descendants', 'Get all descendants (children, grandchildren, etc.) of a specific page. Useful for getting the entire hierarchy under a page.', {
+        pageId: z.string().describe('ID of the page'),
+        type: z
+            .enum(['page', 'comment', 'attachment'])
+            .optional()
+            .default('page')
+            .describe('Type of descendants to retrieve (default: page)'),
+        depth: z
+            .enum(['all', 'root'])
+            .optional()
+            .describe('Depth of descendants: "all" for entire tree, "root" for direct children only'),
+        start: z.number().min(0).optional().describe('Starting index for pagination (default: 0)'),
+        limit: z
+            .number()
+            .min(1)
+            .max(250)
+            .optional()
+            .describe('Maximum number of results to return (default: 25, max: 250)'),
+    }, async ({ pageId, type, depth, start, limit }) => {
+        try {
+            const result = await confluenceService.getPageDescendants(pageId, {
+                type,
+                depth,
+                start,
+                limit,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get page descendants: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/get-space-root-content.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+export const registerGetSpaceRootContent = (server, confluenceService) => {
+    server.tool('get-space-root-content', "Get root-level content (pages, folders, etc.) of a Confluence space. This retrieves the direct children of the space's homepage.", {
+        spaceId: z.string().describe('ID of the space'),
+        type: z
+            .enum(['page', 'folder', 'whiteboard', 'database', 'embed'])
+            .optional()
+            .describe('Filter by content type (page, folder, whiteboard, database, embed)'),
+        cursor: z.string().optional().describe('Cursor for pagination'),
+        limit: z
+            .number()
+            .min(1)
+            .max(250)
+            .optional()
+            .describe('Maximum number of results to return (default: 25, max: 250)'),
+        sort: z
+            .enum([
+            'id',
+            '-id',
+            'created-date',
+            '-created-date',
+            'modified-date',
+            '-modified-date',
+            'title',
+            '-title',
+        ])
+            .optional()
+            .describe('Sort order for results'),
+    }, async ({ spaceId, type, cursor, limit, sort }) => {
+        try {
+            const result = await confluenceService.getSpaceRootContent(spaceId, {
+                type,
+                cursor,
+                limit,
+                sort,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get space root content: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

package/dist/confluence-tools/index.js

@@ -7,9 +7,11 @@ export { registerFindPagesByLabelName } from './find-pages-by-label-name.js';
 export { registerFindLabelByName } from './find-label-by-name.js';
 export { registerGetPageChildren } from './get-page-children.js';
 export { registerGetPageChildrenTree } from './get-page-children-tree.js';
+export { registerGetPageDescendants } from './get-page-descendants.js';
 export { registerGetSpaces } from './get-spaces.js';
 export { registerGetSpaceById } from './get-space-by-id.js';
 export { registerFindSpaceByName } from './find-space-by-name.js';
+export { registerGetSpaceRootContent } from './get-space-root-content.js';
 export { registerGetRecentlyUpdatedPages } from './get-recently-updated-pages.js';
 export { registerGetRecentlyCreatedPages } from './get-recently-created-pages.js';
 export { registerGetTemplates } from './get-templates.js';
@@ -20,5 +22,11 @@ export { registerUpdatePage } from './update-page.js';
 export { registerDeletePage } from './delete-page.js';
 export { registerAddLabelsToPage } from './add-labels-to-page.js';
 export { registerRemoveLabelFromPage } from './remove-label-from-page.js';
+export { registerMovePage } from './move-page.js';
+// Folder tools
+export { registerCreateFolder } from './create-folder.js';
+export { registerGetFolderById } from './get-folder-by-id.js';
+export { registerDeleteFolder } from './delete-folder.js';
+export { registerGetFolderChildren } from './get-folder-children.js';
 // Help tool
 export { registerConfluenceStorageFormatHelp } from './confluence-storage-format-help.js';

package/dist/confluence-tools/move-page.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export const registerMovePage = (server, confluenceService) => {
+    server.tool('move-page', 'Move a Confluence page to a new location. Use position "append" to move the page as a child of the target (page or folder). Use "before" or "after" to move the page as a sibling of the target.', {
+        pageId: z.string().describe('ID of the page to move'),
+        targetId: z
+            .string()
+            .describe('ID of the target page or folder. The page will be moved relative to this target.'),
+        position: z
+            .enum(['before', 'after', 'append'])
+            .default('append')
+            .describe('Position relative to targetId: "append" = move as child of target (use for moving into folders), "before" = move before target (same parent), "after" = move after target (same parent)'),
+    }, async ({ pageId, targetId, position }) => {
+        try {
+            const result = await confluenceService.movePage(pageId, {
+                targetId,
+                position,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to move page: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    });
+};

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, registerGetTemplates, registerGetTemplateById, registerCreatePage, registerUpdatePage, registerDeletePage, registerAddLabelsToPage, registerRemoveLabelFromPage, registerConfluenceStorageFormatHelp, } from './confluence-tools/index.js';
+import { registerGetPages, registerGetPagesForLabel, registerGetPageById, registerGetLabels, registerFindPagesByLabelName, registerFindLabelByName, registerGetPageChildren, registerGetPageChildrenTree, registerGetPageDescendants, registerGetSpaces, registerGetSpaceById, registerFindSpaceByName, registerGetSpaceRootContent, registerGetRecentlyUpdatedPages, registerGetRecentlyCreatedPages, registerGetTemplates, registerGetTemplateById, registerCreatePage, registerUpdatePage, registerDeletePage, registerAddLabelsToPage, registerRemoveLabelFromPage, registerMovePage, registerCreateFolder, registerGetFolderById, registerDeleteFolder, registerGetFolderChildren, registerConfluenceStorageFormatHelp, } from './confluence-tools/index.js';
 export const registerConfluenceTools = (server) => {
     // Initialize Confluence service
     const confluenceService = new ConfluenceService();
@@ -12,9 +12,11 @@ export const registerConfluenceTools = (server) => {
     registerFindLabelByName(server, confluenceService);
     registerGetPageChildren(server, confluenceService);
     registerGetPageChildrenTree(server, confluenceService);
+    registerGetPageDescendants(server, confluenceService);
     registerGetSpaces(server, confluenceService);
     registerGetSpaceById(server, confluenceService);
     registerFindSpaceByName(server, confluenceService);
+    registerGetSpaceRootContent(server, confluenceService);
     registerGetRecentlyUpdatedPages(server, confluenceService);
     registerGetRecentlyCreatedPages(server, confluenceService);
     registerGetTemplates(server, confluenceService);
@@ -25,6 +27,12 @@ export const registerConfluenceTools = (server) => {
     registerDeletePage(server, confluenceService);
     registerAddLabelsToPage(server, confluenceService);
     registerRemoveLabelFromPage(server, confluenceService);
+    registerMovePage(server, confluenceService);
+    // Register folder tools
+    registerCreateFolder(server, confluenceService);
+    registerGetFolderById(server, confluenceService);
+    registerDeleteFolder(server, confluenceService);
+    registerGetFolderChildren(server, confluenceService);
     // Register help tool
     registerConfluenceStorageFormatHelp(server);
 };

package/dist/libs/confluence-client.js

@@ -159,7 +159,7 @@ export class ConfluenceService extends BaseApiService {
             if (sort)
                 params.sort = sort;
         }
-        return this.makeRequest(() => this.client.get(`/pages/${pageId}/children`, { params }));
+        return this.makeRequest(() => this.client.get(`/pages/${pageId}/direct-children`, { params }));
     }
     /**
      * 페이지의 전체 하위 트리를 재귀적으로 가져오는 편의 함수
@@ -383,4 +383,128 @@ export class ConfluenceService extends BaseApiService {
         }
         return this.makeRequest(() => this.v1Client.get(`/template/page/${contentTemplateId}`, { params }));
     }
+    /**
+     * 페이지를 다른 위치로 이동
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---children-and-descendants/#api-wiki-rest-api-content-pageid-move-position-targetid-put
+     * 참고: Move API는 v1 API를 사용 (/wiki/rest/api/content)
+     * @param pageId 이동할 페이지 ID
+     * @param options.targetId 목표 페이지 또는 폴더 ID
+     * @param options.position 이동 위치: 'before', 'after', 'append'
+     */
+    async movePage(pageId, options) {
+        const { targetId, position } = options;
+        return this.makeRequest(() => this.v1Client.put(`/content/${pageId}/move/${position}/${targetId}`, null, {
+            headers: {
+                'Accept': 'application/json',
+            },
+        }));
+    }
+    /**
+     * 폴더 생성
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-folder/#api-wiki-api-v2-folders-post
+     * @param options.spaceId Space ID
+     * @param options.title 폴더 제목
+     * @param options.parentId 부모 폴더 ID (없으면 Space 루트에 생성)
+     */
+    async createFolder(options) {
+        const { spaceId, title, parentId } = options;
+        const requestBody = {
+            spaceId,
+            title,
+        };
+        if (parentId) {
+            requestBody.parentId = parentId;
+        }
+        return this.makeRequest(() => this.client.post('/folders', requestBody, {
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        }));
+    }
+    /**
+     * 특정 폴더 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-folder/#api-wiki-api-v2-folders-id-get
+     * @param folderId 폴더 ID
+     */
+    async getFolderById(folderId) {
+        return this.makeRequest(() => this.client.get(`/folders/${folderId}`));
+    }
+    /**
+     * 폴더 삭제 (휴지통으로 이동)
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-folder/#api-wiki-api-v2-folders-id-delete
+     * @param folderId 삭제할 폴더 ID
+     */
+    async deleteFolder(folderId) {
+        return this.makeRequest(() => this.client.delete(`/folders/${folderId}`));
+    }
+    /**
+     * 폴더의 직접 자식 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-children/#api-wiki-api-v2-folders-id-direct-children-get
+     * @param folderId 폴더 ID
+     * @param options 조회 옵션
+     */
+    async getFolderChildren(folderId, options) {
+        const params = {};
+        if (options) {
+            const { cursor, limit, sort } = options;
+            if (cursor)
+                params.cursor = cursor;
+            if (limit)
+                params.limit = limit;
+            if (sort)
+                params.sort = sort;
+        }
+        return this.makeRequest(() => this.client.get(`/folders/${folderId}/direct-children`, { params }));
+    }
+    /**
+     * Space의 루트 콘텐츠 조회 (homepage의 직접 자식)
+     * 참고: Space의 homepage 페이지의 자식들을 조회하여 루트 콘텐츠를 반환
+     * @param spaceId Space ID
+     * @param options 조회 옵션
+     */
+    async getSpaceRootContent(spaceId, options) {
+        // 1. Space 정보 조회하여 homepage ID 가져오기
+        const space = await this.getSpaceById(spaceId);
+        if (!space.homepageId) {
+            return {
+                results: [],
+                homepageId: undefined,
+            };
+        }
+        const homepageId = space.homepageId;
+        // 2. Homepage의 자식들 조회
+        const { type, ...restOptions } = options || {};
+        const result = await this.getPageChildren(homepageId, restOptions);
+        // 3. type 필터 적용 (클라이언트 측)
+        let filteredResults = result.results;
+        if (type) {
+            filteredResults = result.results.filter((child) => child.type === type);
+        }
+        return {
+            results: filteredResults,
+            cursor: result.cursor,
+            _links: result._links,
+            homepageId,
+        };
+    }
+    /**
+     * 페이지의 모든 후손(descendants) 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-content---children-and-descendants/#api-wiki-rest-api-content-id-descendant-type-get
+     * 참고: Descendants API는 v1 API를 사용 (/wiki/rest/api/content)
+     * @param pageId 페이지 ID
+     * @param options 조회 옵션
+     */
+    async getPageDescendants(pageId, options) {
+        const { type = 'page', depth, start, limit, expand } = options || {};
+        const params = {};
+        if (depth)
+            params.depth = depth;
+        if (start !== undefined)
+            params.start = start;
+        if (limit !== undefined)
+            params.limit = limit;
+        if (expand)
+            params.expand = expand.join(',');
+        return this.makeRequest(() => this.v1Client.get(`/content/${pageId}/descendant/${type}`, { params }));
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecubelabs/atlassian-mcp",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "bin": "./dist/index.js",
   "repository": {
     "url": "https://github.com/Ecube-Labs/skynet.git"
@@ -19,7 +19,7 @@
   "packageManager": "yarn@4.1.0",
   "type": "module",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.3",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "axios": "^1.12.0",
     "axios-retry": "^4.5.0",
     "dotenv": "^17.2.0",