@ecubelabs/atlassian-mcp 1.2.0 → 1.3.0

package/dist/libs/base-client.js

@@ -19,15 +19,42 @@ export class BaseApiService {
     }
     setupAxiosClient() {
         const auth = Buffer.from(`${this.config.email}:${this.config.apiToken}`).toString('base64');
+        const baseURL = this.serviceName === 'ConfluenceService'
+            ? `${this.config.host}/wiki/api/v${this.config.apiVersion}`
+            : `${this.config.host}/rest/api/${this.config.apiVersion}`;
         return axios.create({
-            baseURL: `${this.config.host}/rest/api/${this.config.apiVersion}`,
+            baseURL,
             headers: {
                 Authorization: `Basic ${auth}`,
                 Accept: 'application/json',
                 'Content-Type': 'application/json',
             },
             timeout: 30000,
+            paramsSerializer: (params) => {
+                return this.serviceName === 'ConfluenceService'
+                    ? this.serializeConfluenceParams(params)
+                    : new URLSearchParams(params).toString();
+            },
+        });
+    }
+    serializeConfluenceParams(params) {
+        const searchParams = new URLSearchParams();
+        Object.entries(params).forEach(([key, value]) => {
+            if (value === undefined || value === null)
+                return;
+            if (Array.isArray(value)) {
+                // 배열의 경우 각 값을 개별적으로 추가 (대괄호 없이)
+                value.forEach((item) => {
+                    if (item !== undefined && item !== null) {
+                        searchParams.append(key, String(item));
+                    }
+                });
+            }
+            else {
+                searchParams.append(key, String(value));
+            }
         });
+        return searchParams.toString();
     }
     setupInterceptors() {
         // Request 인터셉터
@@ -85,7 +112,7 @@ export class BaseApiService {
         if (response.data?.message) {
             return response.data.message;
         }
-        return 'Unknown error occurred';
+        return JSON.stringify(response.data) || 'Unknown error occurred';
     }
     // Rate limited request wrapper
     async makeRequest(requestFn) {

package/dist/libs/confluence-client.js

@@ -0,0 +1,277 @@
+import { atlassianConfig } from '../config.js';
+import { BaseApiService } from './base-client.js';
+export class ConfluenceService extends BaseApiService {
+    constructor() {
+        super(atlassianConfig.confluence, 'ConfluenceService');
+    }
+    /**
+     * 모든 페이지 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-wiki-api-v2-pages-get
+     */
+    async getPages(options) {
+        const params = {};
+        if (options) {
+            const { id, spaceId, title, status, bodyFormat, cursor, limit, sort } = options;
+            if (id)
+                params.id = id;
+            if (spaceId)
+                params['space-id'] = spaceId;
+            if (title)
+                params.title = title;
+            if (status)
+                params.status = status;
+            if (bodyFormat)
+                params['body-format'] = bodyFormat;
+            if (cursor)
+                params.cursor = cursor;
+            if (limit)
+                params.limit = limit;
+            if (sort)
+                params.sort = sort;
+        }
+        return this.makeRequest(() => this.client.get('/pages', { params }));
+    }
+    /**
+     * 특정 페이지 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-wiki-api-v2-pages-id-get
+     */
+    async getPageById(pageId, options) {
+        const params = {};
+        if (options) {
+            const { bodyFormat, getDraft, version } = options;
+            if (bodyFormat)
+                params['body-format'] = bodyFormat;
+            if (getDraft !== undefined)
+                params['get-draft'] = getDraft;
+            if (version !== undefined)
+                params.version = version;
+        }
+        return this.makeRequest(() => this.client.get(`/pages/${pageId}`, { params }));
+    }
+    /**
+     * 라벨로 페이지 검색
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-wiki-api-v2-labels-id-pages-get
+     */
+    async getPagesByLabel(labelId, options) {
+        const params = {};
+        if (options) {
+            const { bodyFormat, sort, cursor, limit } = options;
+            if (bodyFormat)
+                params['body-format'] = bodyFormat;
+            if (sort)
+                params.sort = sort;
+            if (cursor)
+                params.cursor = cursor;
+            if (limit)
+                params.limit = limit;
+        }
+        return this.makeRequest(() => this.client.get(`/labels/${labelId}/pages`, { params }));
+    }
+    /**
+     * 라벨 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-label/#api-wiki-api-v2-labels-get
+     * 참고: API는 label-id와 prefix 필터만 지원하며, 이름으로 직접 검색은 불가능
+     */
+    async getLabels(options) {
+        const params = {};
+        if (options) {
+            const { ids, prefix, cursor, limit, sort } = options;
+            if (ids)
+                params['label-id'] = ids;
+            if (prefix)
+                params.prefix = prefix;
+            if (cursor)
+                params.cursor = cursor;
+            if (limit)
+                params.limit = limit;
+            if (sort)
+                params.sort = sort;
+        }
+        return this.makeRequest(() => this.client.get('/labels', { params }));
+    }
+    /**
+     * 레이블 이름으로 레이블 검색 (편의 함수)
+     * 참고: API가 이름 검색을 직접 지원하지 않으므로 모든 레이블을 조회하여 클라이언트 측에서 필터링
+     * @param labelName 검색할 레이블 이름 (정확한 일치)
+     */
+    async findLabelByName(labelName) {
+        try {
+            let cursor;
+            // 모든 레이블을 페이지별로 가져와서 검색
+            do {
+                const result = await this.getLabels({ cursor, limit: 250 });
+                // 현재 페이지에서 일치하는 레이블을 먼저 확인
+                const found = result.results.find((label) => label.name === labelName);
+                if (found) {
+                    return found;
+                }
+                // 다음 페이지가 있는지 확인 (_links.next 존재 여부로 판단)
+                cursor = result._links?.next ? result.cursor : undefined;
+            } while (cursor);
+            return null;
+        }
+        catch (error) {
+            console.error(`Error finding label by name "${labelName}":`, error);
+            return null;
+        }
+    }
+    /**
+     * 레이블 이름으로 검색하여 페이지 조회 (편의 함수)
+     * 참고: API 제한으로 인해 모든 레이블을 조회 후 클라이언트 측에서 필터링합니다
+     * @param labelName 검색할 레이블 이름 (정확한 일치)
+     * @param options 페이지 검색 옵션
+     */
+    async getPagesByLabelName(labelName, options) {
+        // 먼저 레이블 찾기
+        const label = await this.findLabelByName(labelName);
+        if (!label) {
+            // 레이블을 찾지 못한 경우 빈 결과를 반환하고 디버그 정보 제공
+            return {
+                results: [],
+                labelInfo: undefined,
+                _links: {
+                    base: `${this.client.defaults.baseURL}`,
+                },
+                error: `Label "${labelName}" not found. Please check if the label exists and has the correct name.`,
+            };
+        }
+        // 레이블 ID로 페이지 검색
+        const result = await this.getPagesByLabel(label.id, options);
+        return {
+            ...result,
+            labelInfo: label,
+        };
+    }
+    /**
+     * 페이지의 하위 페이지 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-children/#api-wiki-api-v2-pages-id-children-get
+     * @param pageId 부모 페이지 ID
+     * @param options 조회 옵션
+     */
+    async getPageChildren(pageId, 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(`/pages/${pageId}/children`, { params }));
+    }
+    /**
+     * 페이지의 전체 하위 트리를 재귀적으로 가져오는 편의 함수
+     * @param pageId 루트 페이지 ID
+     * @param options 조회 옵션
+     * @param maxDepth 최대 깊이 (기본값: 10, 무제한: -1)
+     * @param currentDepth 현재 깊이 (내부 사용)
+     */
+    async getPageChildrenTree(pageId, options, maxDepth = 10, currentDepth = 0) {
+        // 최대 깊이 제한 확인
+        if (maxDepth !== -1 && currentDepth >= maxDepth) {
+            return [];
+        }
+        try {
+            // 현재 페이지의 직접 자식들 가져오기
+            const result = await this.getPageChildren(pageId, options);
+            const childrenWithSubTree = [];
+            // 각 자식에 대해 재귀적으로 하위 트리 가져오기
+            for (const child of result.results) {
+                const childWithTree = { ...child };
+                // 재귀적으로 하위 트리 가져오기
+                const subTree = await this.getPageChildrenTree(child.id, options, maxDepth, currentDepth + 1);
+                if (subTree.length > 0) {
+                    childWithTree.children = subTree;
+                }
+                childrenWithSubTree.push(childWithTree);
+            }
+            return childrenWithSubTree;
+        }
+        catch (error) {
+            console.error(`Error fetching children for page ${pageId} at depth ${currentDepth}:`, error);
+            return [];
+        }
+    }
+    /**
+     * 모든 Space 목록 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-wiki-api-v2-spaces-get
+     */
+    async getSpaces(options) {
+        const params = {};
+        if (options) {
+            const { id, keys, type, status, sort, cursor, limit } = options;
+            if (id)
+                params.id = id;
+            if (keys)
+                params.key = keys;
+            if (type)
+                params.type = type;
+            if (status)
+                params.status = status;
+            if (sort)
+                params.sort = sort;
+            if (cursor)
+                params.cursor = cursor;
+            if (limit)
+                params.limit = limit;
+        }
+        return this.makeRequest(() => this.client.get('/spaces', { params }));
+    }
+    /**
+     * 특정 Space 조회
+     * @see https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-space/#api-wiki-api-v2-spaces-id-get
+     */
+    async getSpaceById(spaceId) {
+        return this.makeRequest(() => this.client.get(`/spaces/${spaceId}`));
+    }
+    /**
+     * Space name으로 Space 검색 (편의 함수)
+     * 참고: API가 이름 검색을 직접 지원하지 않으므로 모든 Space를 조회하여 클라이언트 측에서 필터링
+     * @param spaceName 검색할 Space 이름 (정확한 일치)
+     */
+    async findSpaceByName(spaceName) {
+        try {
+            let cursor;
+            // 모든 Space를 페이지별로 가져와서 검색
+            do {
+                const result = await this.getSpaces({ cursor, limit: 250 });
+                // 현재 페이지에서 일치하는 Space를 먼저 확인
+                const found = result.results.find((space) => space.name === spaceName);
+                if (found) {
+                    return found;
+                }
+                // 다음 페이지가 있는지 확인 (_links.next 존재 여부로 판단)
+                cursor = result._links?.next ? result.cursor : undefined;
+            } while (cursor);
+            return null;
+        }
+        catch (error) {
+            console.error(`Error finding space by name "${spaceName}":`, error);
+            return null;
+        }
+    }
+    /**
+     * 최신 문서 조회 (최근 수정된 페이지들)
+     * @param options 조회 옵션
+     */
+    async getRecentlyUpdatedPages(options) {
+        return this.getPages({
+            ...options,
+            sort: '-modified-date', // 최근 수정일 기준 내림차순
+            status: ['current'], // 현재 상태인 페이지만
+        });
+    }
+    /**
+     * 최신 생성된 문서 조회
+     * @param options 조회 옵션
+     */
+    async getRecentlyCreatedPages(options) {
+        return this.getPages({
+            ...options,
+            sort: '-created-date', // 최근 생성일 기준 내림차순
+            status: ['current'], // 현재 상태인 페이지만
+        });
+    }
+}

package/package.json

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