bamboo-mcp-server 1.0.10 → 1.1.2

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+## [1.1.2](https://github.com/norus/atlassian-bamboo-mcp/compare/v1.1.1...v1.1.2) (2026-01-09)
+
+
+### Bug Fixes
+
+* **ci:** match original publish.yml setup for trusted publishers ([2ff9306](https://github.com/norus/atlassian-bamboo-mcp/commit/2ff930679ee15f91bd8e9b7de78428db3683ba29))
+
+## [1.1.1](https://github.com/norus/atlassian-bamboo-mcp/compare/v1.1.0...v1.1.1) (2026-01-09)
+
+
+### Bug Fixes
+
+* **ci:** remove registry-url to fix OIDC auth ([af9ff11](https://github.com/norus/atlassian-bamboo-mcp/commit/af9ff111d95206a422c7bfa90f355750aaacd4a8))
+
+# [1.1.0](https://github.com/norus/atlassian-bamboo-mcp/compare/v1.0.11...v1.1.0) (2026-01-09)
+
+
+### Bug Fixes
+
+* **ci:** use native npm publish for trusted publishers ([a24ad47](https://github.com/norus/atlassian-bamboo-mcp/commit/a24ad4716b10284271a9e83b5a789acf6f140401))
+* **ci:** use Node 22 for semantic-release ([8c9db06](https://github.com/norus/atlassian-bamboo-mcp/commit/8c9db06200ecd640b616cc4aaf3188c9159d49dd))
+
+
+### Features
+
+* add automated releases with semantic-release ([9bcaa2d](https://github.com/norus/atlassian-bamboo-mcp/commit/9bcaa2d4e36cc8cccb171e068c709287bb5bf6ef))

package/dist/bamboo-client.js

@@ -1,4 +1,22 @@
 import { ProxyAgent, fetch as undiciFetch } from 'undici';
+/**
+ * Build a URL query string from optional parameters
+ */
+function buildQueryString(params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            searchParams.set(key, String(value));
+        }
+    }
+    return searchParams.toString();
+}
+/**
+ * Append query string to endpoint if not empty
+ */
+function appendQuery(endpoint, query) {
+    return query ? `${endpoint}?${query}` : endpoint;
+}
 export class BambooClient {
     baseUrl;
     token;
@@ -47,46 +65,38 @@ export class BambooClient {
     }
     // Project endpoints
     async listProjects(params) {
-        const searchParams = new URLSearchParams();
-        if (params?.expand)
-            searchParams.set('expand', params.expand);
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        const query = searchParams.toString();
-        return this.request(`/project${query ? `?${query}` : ''}`);
+        const query = buildQueryString({
+            'expand': params?.expand,
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+        });
+        return this.request(appendQuery('/project', query));
     }
     async getProject(projectKey, expand) {
-        const query = expand ? `?expand=${expand}` : '';
-        return this.request(`/project/${projectKey}${query}`);
+        const query = buildQueryString({ expand });
+        return this.request(appendQuery(`/project/${projectKey}`, query));
     }
     // Plan endpoints
     async listPlans(params) {
-        const searchParams = new URLSearchParams();
-        if (params?.expand)
-            searchParams.set('expand', params.expand);
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        const query = searchParams.toString();
-        return this.request(`/plan${query ? `?${query}` : ''}`);
+        const query = buildQueryString({
+            'expand': params?.expand,
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+        });
+        return this.request(appendQuery('/plan', query));
     }
     async getPlan(planKey, expand) {
-        const query = expand ? `?expand=${expand}` : '';
-        return this.request(`/plan/${planKey}${query}`);
+        const query = buildQueryString({ expand });
+        return this.request(appendQuery(`/plan/${planKey}`, query));
     }
     async searchPlans(name, params) {
-        const searchParams = new URLSearchParams();
-        searchParams.set('searchTerm', name);
-        if (params?.fuzzy !== undefined)
-            searchParams.set('fuzzy', String(params.fuzzy));
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        return this.request(`/search/plans?${searchParams.toString()}`);
+        const query = buildQueryString({
+            'searchTerm': name,
+            'fuzzy': params?.fuzzy,
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+        });
+        return this.request(`/search/plans?${query}`);
     }
     async enablePlan(planKey) {
         return this.request(`/plan/${planKey}/enable`, { method: 'POST' });
@@ -96,37 +106,31 @@ export class BambooClient {
     }
     // Branch endpoints
     async listPlanBranches(planKey, params) {
-        const searchParams = new URLSearchParams();
-        if (params?.enabledOnly !== undefined)
-            searchParams.set('enabledOnly', String(params.enabledOnly));
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        const query = searchParams.toString();
-        return this.request(`/plan/${planKey}/branch${query ? `?${query}` : ''}`);
+        const query = buildQueryString({
+            'enabledOnly': params?.enabledOnly,
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+        });
+        return this.request(appendQuery(`/plan/${planKey}/branch`, query));
     }
     async getPlanBranch(planKey, branchName) {
         return this.request(`/plan/${planKey}/branch/${encodeURIComponent(branchName)}`);
     }
     // Build endpoints
     async triggerBuild(planKey, params) {
-        const searchParams = new URLSearchParams();
-        if (params?.stage)
-            searchParams.set('stage', params.stage);
-        if (params?.executeAllStages !== undefined) {
-            searchParams.set('executeAllStages', String(params.executeAllStages));
-        }
-        if (params?.customRevision)
-            searchParams.set('customRevision', params.customRevision);
-        // Add bamboo variables
+        const queryParams = {
+            'stage': params?.stage,
+            'executeAllStages': params?.executeAllStages,
+            'customRevision': params?.customRevision,
+        };
+        // Add bamboo variables with prefixed keys
         if (params?.variables) {
             for (const [key, value] of Object.entries(params.variables)) {
-                searchParams.set(`bamboo.variable.${key}`, value);
+                queryParams[`bamboo.variable.${key}`] = value;
             }
         }
-        const query = searchParams.toString();
-        return this.request(`/queue/${planKey}${query ? `?${query}` : ''}`, { method: 'POST' });
+        const query = buildQueryString(queryParams);
+        return this.request(appendQuery(`/queue/${planKey}`, query), { method: 'POST' });
     }
     async stopBuild(planKey) {
         // To stop a build, we need to DELETE the job keys (not the plan key)
@@ -181,25 +185,21 @@ export class BambooClient {
         };
     }
     async getBuildResult(buildKey, expand) {
-        const query = expand ? `?expand=${expand}` : '';
-        return this.request(`/result/${buildKey}${query}`);
+        const query = buildQueryString({ expand });
+        return this.request(appendQuery(`/result/${buildKey}`, query));
     }
     async getLatestBuildResult(planKey, expand) {
-        const query = expand ? `?expand=${expand}` : '';
-        return this.request(`/result/${planKey}/latest${query}`);
+        const query = buildQueryString({ expand });
+        return this.request(appendQuery(`/result/${planKey}/latest`, query));
     }
     async listBuildResults(params) {
-        const searchParams = new URLSearchParams();
-        if (params?.buildState)
-            searchParams.set('buildstate', params.buildState);
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        if (params?.expand)
-            searchParams.set('expand', params.expand);
-        if (params?.includeAllStates)
-            searchParams.set('includeAllStates', 'true');
+        const query = buildQueryString({
+            'buildstate': params?.buildState,
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+            'expand': params?.expand,
+            'includeAllStates': params?.includeAllStates,
+        });
         let endpoint = '/result';
         if (params?.projectKey && params?.planKey) {
             endpoint = `/result/${params.projectKey}-${params.planKey}`;
@@ -207,8 +207,7 @@ export class BambooClient {
         else if (params?.projectKey) {
             endpoint = `/result/${params.projectKey}`;
         }
-        const query = searchParams.toString();
-        return this.request(`${endpoint}${query ? `?${query}` : ''}`);
+        return this.request(appendQuery(endpoint, query));
     }
     async getBuildLogs(buildKey, jobKey) {
         // Build logs are obtained by getting the job result with logFiles expand
@@ -324,22 +323,20 @@ export class BambooClient {
         return this.request(`/queue/deployment?versionId=${versionId}&environmentId=${environmentId}`, { method: 'POST' });
     }
     async getDeploymentResults(environmentId, params) {
-        const searchParams = new URLSearchParams();
-        if (params?.startIndex)
-            searchParams.set('start-index', String(params.startIndex));
-        if (params?.maxResults)
-            searchParams.set('max-result', String(params.maxResults));
-        const query = searchParams.toString();
-        return this.request(`/deploy/environment/${environmentId}/results${query ? `?${query}` : ''}`);
+        const query = buildQueryString({
+            'start-index': params?.startIndex,
+            'max-result': params?.maxResults,
+        });
+        return this.request(appendQuery(`/deploy/environment/${environmentId}/results`, query));
     }
     async getDeploymentResult(deploymentResultId, params) {
-        const searchParams = new URLSearchParams();
-        if (params?.includeLogs) {
-            searchParams.set('includeLogs', 'true');
-            searchParams.set('max-result', String(params?.maxLogLines || 1000));
-        }
-        const query = searchParams.toString();
-        return this.request(`/deploy/result/${deploymentResultId}${query ? `?${query}` : ''}`);
+        const query = params?.includeLogs
+            ? buildQueryString({
+                'includeLogs': true,
+                'max-result': params?.maxLogLines || 1000,
+            })
+            : '';
+        return this.request(appendQuery(`/deploy/result/${deploymentResultId}`, query));
     }
 }
 // Factory function to create client from environment variables

package/dist/index.js

@@ -29,14 +29,12 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Handle graceful shutdown
-    process.on('SIGINT', async () => {
+    async function shutdown() {
         await server.close();
         process.exit(0);
-    });
-    process.on('SIGTERM', async () => {
-        await server.close();
-        process.exit(0);
-    });
+    }
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
 }
 main().catch((error) => {
     console.error('Fatal error:', error);

package/dist/tools/branches.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { formatError, jsonResponse } from './utils.js';
 export function registerBranchTools(server, client) {
-    // List plan branches
     server.tool('bamboo_list_plan_branches', 'List all branches for a Bamboo build plan', {
         plan_key: z.string().describe('The plan key (e.g., "PROJ-PLAN")'),
         enabled_only: z.boolean().optional().describe('Only return enabled branches'),
@@ -13,53 +13,22 @@ export function registerBranchTools(server, client) {
                 startIndex: start_index,
                 maxResults: max_results,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(branches, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(branches);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get plan branch
     server.tool('bamboo_get_plan_branch', 'Get details of a specific plan branch', {
         plan_key: z.string().describe('The plan key (e.g., "PROJ-PLAN")'),
         branch_name: z.string().describe('The branch name'),
     }, async ({ plan_key, branch_name }) => {
         try {
             const branch = await client.getPlanBranch(plan_key, branch_name);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(branch, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(branch);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/builds.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { formatError, jsonResponse } from './utils.js';
 export function registerBuildTools(server, client) {
-    // Trigger build
     server.tool('bamboo_trigger_build', 'Trigger a build for a Bamboo plan', {
         plan_key: z.string().describe('The plan key to build (e.g., "PROJ-PLAN")'),
         stage: z.string().optional().describe('Specific stage to execute'),
@@ -15,111 +15,47 @@ export function registerBuildTools(server, client) {
                 customRevision: custom_revision,
                 variables,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Stop build
     server.tool('bamboo_stop_build', 'Stop a running build for a Bamboo plan', {
         plan_key: z.string().describe('The plan key to stop (e.g., "PROJ-PLAN")'),
     }, async ({ plan_key }) => {
         try {
             const result = await client.stopBuild(plan_key);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get build result
     server.tool('bamboo_get_build_result', 'Get the result of a specific build', {
         build_key: z.string().describe('The build result key (e.g., "PROJ-PLAN-123")'),
         expand: z.string().optional().describe('Fields to expand (e.g., "changes,artifacts,testResults")'),
     }, async ({ build_key, expand }) => {
         try {
             const result = await client.getBuildResult(build_key, expand);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get latest build result
     server.tool('bamboo_get_latest_result', 'Get the latest build result for a plan', {
         plan_key: z.string().describe('The plan key (e.g., "PROJ-PLAN")'),
         expand: z.string().optional().describe('Fields to expand (e.g., "changes,artifacts,testResults")'),
     }, async ({ plan_key, expand }) => {
         try {
             const result = await client.getLatestBuildResult(plan_key, expand);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // List build results
     server.tool('bamboo_list_build_results', 'List build results with optional filters', {
         project_key: z.string().optional().describe('Filter by project key'),
         plan_key: z.string().optional().describe('Filter by plan key (requires project_key)'),
@@ -139,56 +75,24 @@ export function registerBuildTools(server, client) {
                 expand,
                 includeAllStates: include_all_states,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(results, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(results);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get build logs
     server.tool('bamboo_get_build_logs', 'Get the build logs for a specific build. Returns log file URLs that can be accessed via browser.', {
         build_key: z.string().describe('The build result key (e.g., "PROJ-PLAN-123")'),
         job_key: z.string().optional().describe('Specific job key to get logs for'),
     }, async ({ build_key, job_key }) => {
         try {
             const logs = await client.getBuildLogs(build_key, job_key);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(logs, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(logs);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get build result with log content
     server.tool('bamboo_get_build_result_logs', 'Get build result with actual log content. For plan builds, fetches logs from all jobs. For job builds, returns logs directly.', {
         build_key: z.string().describe('The build result key - can be plan level (e.g., "PROJ-PLAN-123") or job level (e.g., "PROJ-PLAN-JOB1-123")'),
         max_log_lines: z.number().optional().describe('Maximum number of log lines per job (default: 1000)'),
@@ -197,25 +101,10 @@ export function registerBuildTools(server, client) {
             const result = await client.getBuildResultWithLogs(build_key, {
                 maxLogLines: max_log_lines,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/deployments.js

@@ -1,86 +1,38 @@
 import { z } from 'zod';
+import { formatError, jsonResponse } from './utils.js';
 export function registerDeploymentTools(server, client) {
-    // List deployment projects
     server.tool('bamboo_list_deployment_projects', 'List all Bamboo deployment projects', {}, async () => {
         try {
             const projects = await client.listDeploymentProjects();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(projects, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(projects);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get deployment project
     server.tool('bamboo_get_deployment_project', 'Get details of a specific deployment project', {
         project_id: z.string().describe('The deployment project ID'),
     }, async ({ project_id }) => {
         try {
             const project = await client.getDeploymentProject(project_id);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(project, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(project);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Trigger deployment
     server.tool('bamboo_trigger_deployment', 'Trigger a deployment to an environment', {
         version_id: z.string().describe('The release version ID to deploy'),
         environment_id: z.string().describe('The target environment ID'),
     }, async ({ version_id, environment_id }) => {
         try {
             const result = await client.triggerDeployment(version_id, environment_id);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get deployment results
     server.tool('bamboo_get_deployment_results', 'Get deployment results for an environment', {
         environment_id: z.string().describe('The environment ID'),
         start_index: z.number().optional().describe('Starting index for pagination (default: 0)'),
@@ -91,28 +43,12 @@ export function registerDeploymentTools(server, client) {
                 startIndex: start_index,
                 maxResults: max_results,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(results, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(results);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get deployment result with logs
     server.tool('bamboo_get_deployment_result', 'Get a specific deployment result with optional logs', {
         deployment_result_id: z.string().describe('The deployment result ID'),
         include_logs: z.boolean().optional().describe('Include log entries (default: false)'),
@@ -123,25 +59,10 @@ export function registerDeploymentTools(server, client) {
                 includeLogs: include_logs,
                 maxLogLines: max_log_lines,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(result);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/plans.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { formatError, jsonResponse, textResponse } from './utils.js';
 export function registerPlanTools(server, client) {
-    // List plans
     server.tool('bamboo_list_plans', 'List all Bamboo build plans', {
         expand: z.string().optional().describe('Fields to expand in the response (e.g., "plans.plan.stages")'),
         start_index: z.number().optional().describe('Starting index for pagination (default: 0)'),
@@ -12,56 +12,24 @@ export function registerPlanTools(server, client) {
                 startIndex: start_index,
                 maxResults: max_results,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(plans, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(plans);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get plan
     server.tool('bamboo_get_plan', 'Get details of a specific Bamboo build plan by key', {
         plan_key: z.string().describe('The plan key (e.g., "PROJ-PLAN")'),
         expand: z.string().optional().describe('Fields to expand in the response'),
     }, async ({ plan_key, expand }) => {
         try {
             const plan = await client.getPlan(plan_key, expand);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(plan, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(plan);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Search plans
     server.tool('bamboo_search_plans', 'Search for Bamboo build plans by name', {
         name: z.string().describe('The plan name to search for'),
         fuzzy: z.boolean().optional().describe('Enable fuzzy matching (default: true)'),
@@ -74,79 +42,32 @@ export function registerPlanTools(server, client) {
                 startIndex: start_index,
                 maxResults: max_results,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(plans, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(plans);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Enable plan
     server.tool('bamboo_enable_plan', 'Enable a Bamboo build plan', {
         plan_key: z.string().describe('The plan key to enable (e.g., "PROJ-PLAN")'),
     }, async ({ plan_key }) => {
         try {
             await client.enablePlan(plan_key);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Plan ${plan_key} has been enabled successfully.`,
-                    },
-                ],
-            };
+            return textResponse(`Plan ${plan_key} has been enabled successfully.`);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Disable plan
     server.tool('bamboo_disable_plan', 'Disable a Bamboo build plan', {
         plan_key: z.string().describe('The plan key to disable (e.g., "PROJ-PLAN")'),
     }, async ({ plan_key }) => {
         try {
             await client.disablePlan(plan_key);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Plan ${plan_key} has been disabled successfully.`,
-                    },
-                ],
-            };
+            return textResponse(`Plan ${plan_key} has been disabled successfully.`);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/projects.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { formatError, jsonResponse } from './utils.js';
 export function registerProjectTools(server, client) {
-    // List projects
     server.tool('bamboo_list_projects', 'List all Bamboo projects', {
         expand: z.string().optional().describe('Fields to expand in the response (e.g., "projects.project.plans")'),
         start_index: z.number().optional().describe('Starting index for pagination (default: 0)'),
@@ -12,53 +12,22 @@ export function registerProjectTools(server, client) {
                 startIndex: start_index,
                 maxResults: max_results,
             });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(projects, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(projects);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get project
     server.tool('bamboo_get_project', 'Get details of a specific Bamboo project by key', {
         project_key: z.string().describe('The project key (e.g., "PROJ")'),
         expand: z.string().optional().describe('Fields to expand in the response'),
     }, async ({ project_key, expand }) => {
         try {
             const project = await client.getProject(project_key, expand);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(project, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(project);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/queue.js

@@ -1,55 +1,24 @@
 import { z } from 'zod';
+import { formatError, jsonResponse } from './utils.js';
 export function registerQueueTools(server, client) {
-    // Get build queue
     server.tool('bamboo_get_build_queue', 'Get the current Bamboo build queue', {
         expand: z.string().optional().describe('Fields to expand (default: "queuedBuilds")'),
     }, async ({ expand }) => {
         try {
             const queue = await client.getBuildQueue(expand);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(queue, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(queue);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Get deployment queue
     server.tool('bamboo_get_deployment_queue', 'Get the current Bamboo deployment queue', {}, async () => {
         try {
             const queue = await client.getDeploymentQueue();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(queue, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(queue);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/server.js

@@ -1,52 +1,21 @@
+import { formatError, jsonResponse } from './utils.js';
 export function registerServerTools(server, client) {
-    // Get server info
     server.tool('bamboo_server_info', 'Get Bamboo server information including version, edition, and state', {}, async () => {
         try {
             const info = await client.getServerInfo();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(info, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(info);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
-    // Health check
     server.tool('bamboo_health_check', 'Check Bamboo server health status', {}, async () => {
         try {
             const health = await client.healthCheck();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(health, null, 2),
-                    },
-                ],
-            };
+            return jsonResponse(health);
         }
         catch (error) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
+            return formatError(error);
         }
     });
 }

package/dist/tools/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared utilities for MCP tool handlers
+ */
+interface ToolResponse {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Format a successful JSON response for MCP tools
+ */
+export declare function jsonResponse(data: unknown): ToolResponse;
+/**
+ * Format a text response for MCP tools
+ */
+export declare function textResponse(message: string): ToolResponse;
+/**
+ * Format an error response for MCP tools
+ */
+export declare function formatError(error: unknown): ToolResponse;
+export {};

package/dist/tools/utils.js

@@ -0,0 +1,44 @@
+/**
+ * Shared utilities for MCP tool handlers
+ */
+/**
+ * Format a successful JSON response for MCP tools
+ */
+export function jsonResponse(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Format a text response for MCP tools
+ */
+export function textResponse(message) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: message,
+            },
+        ],
+    };
+}
+/**
+ * Format an error response for MCP tools
+ */
+export function formatError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Error: ${message}`,
+            },
+        ],
+        isError: true,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bamboo-mcp-server",
-  "version": "1.0.10",
+  "version": "1.1.2",
   "description": "MCP server for Atlassian Bamboo",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,9 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -35,6 +38,7 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "dependencies": {
@@ -43,8 +47,14 @@
     "zod": "^3.22.0"
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/node": "^20.0.0",
-    "typescript": "^5.3.0"
+    "@vitest/coverage-v8": "^4.0.16",
+    "msw": "^2.12.7",
+    "semantic-release": "^24.2.9",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": ">=18.0.0"