@atercates/bitbucket-mcp 1.0.0

package/dist/logger.js

@@ -0,0 +1,60 @@
+import winston from "winston";
+import os from "os";
+import path from "path";
+import fs from "fs";
+// =========== LOGGER SETUP ==========
+// File-based logging with sensible defaults and ability to disable
+function getDefaultLogDirectory() {
+    if (process.platform === "win32") {
+        const base = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+        return path.join(base, "bitbucket-mcp");
+    }
+    if (process.platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Logs", "bitbucket-mcp");
+    }
+    const xdgStateHome = process.env.XDG_STATE_HOME;
+    if (xdgStateHome && xdgStateHome.length > 0) {
+        return path.join(xdgStateHome, "bitbucket-mcp");
+    }
+    return path.join(os.homedir(), ".local", "state", "bitbucket-mcp");
+}
+export function isTruthyEnv(value) {
+    if (value === undefined || value === null)
+        return false;
+    const normalized = String(value).toLowerCase();
+    return ["1", "true", "yes", "on"].includes(normalized);
+}
+function getLogFilePath() {
+    if (isTruthyEnv(process.env.BITBUCKET_LOG_DISABLE)) {
+        return undefined;
+    }
+    const explicitFile = process.env.BITBUCKET_LOG_FILE;
+    if (explicitFile && explicitFile.trim().length > 0) {
+        return explicitFile;
+    }
+    const baseDir = process.env.BITBUCKET_LOG_DIR && process.env.BITBUCKET_LOG_DIR.trim().length > 0
+        ? process.env.BITBUCKET_LOG_DIR
+        : getDefaultLogDirectory();
+    let effectiveDir = baseDir;
+    if (isTruthyEnv(process.env.BITBUCKET_LOG_PER_CWD)) {
+        const sanitizedCwd = process
+            .cwd()
+            .replace(/[\\/]/g, "_")
+            .replace(/[:*?"<>|]/g, "");
+        effectiveDir = path.join(baseDir, sanitizedCwd);
+    }
+    try {
+        fs.mkdirSync(effectiveDir, { recursive: true });
+    }
+    catch {
+        return undefined; // If we cannot create the directory, disable file logging rather than polluting CWD
+    }
+    return path.join(effectiveDir, "bitbucket.log");
+}
+const resolvedLogFile = getLogFilePath();
+export const logger = winston.createLogger({
+    level: "info",
+    format: winston.format.json(),
+    transports: resolvedLogFile ? [new winston.transports.File({ filename: resolvedLogFile })] : [],
+});
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/pagination.d.ts

@@ -0,0 +1,32 @@
+import type { AxiosInstance } from "axios";
+import type winston from "winston";
+export declare const BITBUCKET_DEFAULT_PAGELEN = 10;
+export declare const BITBUCKET_MAX_PAGELEN = 100;
+export declare const BITBUCKET_ALL_ITEMS_CAP = 1000;
+export interface PaginationRequestOptions {
+    pagelen?: number;
+    page?: number;
+    all?: boolean;
+    params?: Record<string, unknown>;
+    defaultPagelen?: number;
+    maxItems?: number;
+    description?: string;
+}
+export interface PaginatedValuesResult<T> {
+    values: T[];
+    page?: number;
+    pagelen: number;
+    next?: string;
+    fetchedPages: number;
+    totalFetched: number;
+    previous?: string;
+}
+export declare class BitbucketPaginator {
+    private readonly api;
+    private readonly logger;
+    constructor(api: AxiosInstance, logger: winston.Logger);
+    fetchValues<T>(path: string, options?: PaginationRequestOptions): Promise<PaginatedValuesResult<T>>;
+    private performRequest;
+    private extractValues;
+    private normalizePagelen;
+}

package/dist/pagination.js

@@ -0,0 +1,116 @@
+export const BITBUCKET_DEFAULT_PAGELEN = 10;
+export const BITBUCKET_MAX_PAGELEN = 100;
+export const BITBUCKET_ALL_ITEMS_CAP = 1000;
+export class BitbucketPaginator {
+    constructor(api, logger) {
+        this.api = api;
+        this.logger = logger;
+    }
+    async fetchValues(path, options = {}) {
+        const { pagelen, page, all = false, params = {}, defaultPagelen = BITBUCKET_DEFAULT_PAGELEN, maxItems = BITBUCKET_ALL_ITEMS_CAP, description, } = options;
+        const resolvedPagelen = this.normalizePagelen(pagelen ?? defaultPagelen);
+        const requestParams = {
+            ...params,
+            pagelen: resolvedPagelen,
+        };
+        if (page !== undefined) {
+            requestParams.page = page;
+        }
+        const shouldFetchAll = all === true && page === undefined;
+        const requestDescriptor = {
+            url: path,
+            params: requestParams,
+        };
+        if (!shouldFetchAll) {
+            const response = await this.performRequest(requestDescriptor, description);
+            const values = this.extractValues(response.data);
+            return {
+                values,
+                page: response.data?.page ?? page,
+                pagelen: response.data?.pagelen ?? resolvedPagelen,
+                next: response.data?.next,
+                previous: response.data?.previous,
+                fetchedPages: 1,
+                totalFetched: values.length,
+            };
+        }
+        const aggregated = [];
+        let fetchedPages = 0;
+        let nextRequest = requestDescriptor;
+        let firstPageMeta = { pagelen: resolvedPagelen };
+        while (nextRequest && aggregated.length < maxItems) {
+            const response = await this.performRequest(nextRequest, description, {
+                page: fetchedPages + 1,
+            });
+            fetchedPages += 1;
+            if (fetchedPages === 1) {
+                firstPageMeta = {
+                    page: response.data?.page,
+                    pagelen: response.data?.pagelen ?? resolvedPagelen,
+                    previous: response.data?.previous,
+                };
+            }
+            const values = this.extractValues(response.data);
+            aggregated.push(...values);
+            if (!response.data?.next) {
+                break;
+            }
+            if (aggregated.length >= maxItems) {
+                this.logger.debug("Bitbucket pagination cap reached", {
+                    description: description ?? path,
+                    maxItems,
+                });
+                break;
+            }
+            this.logger.debug("Following Bitbucket pagination next link", {
+                description: description ?? path,
+                next: response.data.next,
+                fetchedPages,
+                totalFetched: aggregated.length,
+            });
+            nextRequest = { url: response.data.next };
+        }
+        if (aggregated.length > maxItems) {
+            aggregated.length = maxItems;
+        }
+        return {
+            values: aggregated,
+            page: firstPageMeta.page,
+            pagelen: firstPageMeta.pagelen,
+            previous: firstPageMeta.previous,
+            fetchedPages,
+            totalFetched: aggregated.length,
+        };
+    }
+    async performRequest(request, description, extra) {
+        this.logger.debug("Calling Bitbucket API", {
+            description: description ?? request.url,
+            url: request.url,
+            params: request.params,
+            ...extra,
+        });
+        const config = request.params ? { params: request.params } : undefined;
+        return this.api.get(request.url, config);
+    }
+    extractValues(data) {
+        const d = data;
+        if (Array.isArray(d?.values)) {
+            return d.values;
+        }
+        if (Array.isArray(data)) {
+            return data;
+        }
+        return [];
+    }
+    normalizePagelen(value) {
+        if (value === undefined || Number.isNaN(value)) {
+            return BITBUCKET_DEFAULT_PAGELEN;
+        }
+        const integer = Math.floor(value);
+        if (!Number.isFinite(integer) || integer < 1) {
+            return 1;
+        }
+        return Math.min(integer, BITBUCKET_MAX_PAGELEN);
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,21 @@
+export declare const PAGINATION_BASE_SCHEMA: {
+    pagelen: {
+        type: string;
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    page: {
+        type: string;
+        minimum: number;
+        description: string;
+    };
+};
+export declare const PAGINATION_ALL_SCHEMA: {
+    type: string;
+    description: string;
+};
+export declare const LEGACY_LIMIT_SCHEMA: {
+    type: string;
+    description: string;
+};

package/dist/schemas.js

@@ -0,0 +1,23 @@
+import { BITBUCKET_ALL_ITEMS_CAP, BITBUCKET_DEFAULT_PAGELEN, BITBUCKET_MAX_PAGELEN, } from "./pagination.js";
+export const PAGINATION_BASE_SCHEMA = {
+    pagelen: {
+        type: "number",
+        minimum: 1,
+        maximum: BITBUCKET_MAX_PAGELEN,
+        description: `Number of items per page (Bitbucket pagelen). Defaults to ${BITBUCKET_DEFAULT_PAGELEN} and caps at ${BITBUCKET_MAX_PAGELEN}.`,
+    },
+    page: {
+        type: "number",
+        minimum: 1,
+        description: "Bitbucket page number to fetch (1-based).",
+    },
+};
+export const PAGINATION_ALL_SCHEMA = {
+    type: "boolean",
+    description: `When true (and no page is provided), automatically follows Bitbucket next links to return all items up to ${BITBUCKET_ALL_ITEMS_CAP}.`,
+};
+export const LEGACY_LIMIT_SCHEMA = {
+    type: "number",
+    description: "Deprecated alias for pagelen. Use pagelen/page/all for pagination control.",
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,6DAA6D,yBAAyB,gBAAgB,qBAAqB,GAAG;KAC5I;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,2CAA2C;KACzD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,6GAA6G,uBAAuB,GAAG;CACrJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,4EAA4E;CAC1F,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,33 @@
+import { BitbucketConfig } from "./types.js";
+/**
+ * Bitbucket MCP Server with modular handlers
+ */
+export declare class BitbucketMcpServer {
+    private readonly server;
+    private readonly client;
+    private readonly config;
+    private readonly toolHandlers;
+    private readonly toolDefinitions;
+    private readonly dangerousToolNames;
+    constructor(config: BitbucketConfig);
+    /**
+     * Register all handler modules
+     */
+    private registerHandlers;
+    /**
+     * Check if a tool is considered dangerous
+     */
+    private isDangerousTool;
+    /**
+     * Setup MCP tool routing
+     */
+    private setupToolRouting;
+    /**
+     * Start the server with stdio transport
+     */
+    run(): Promise<void>;
+}
+/**
+ * Create and run server from environment config
+ */
+export declare function main(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,124 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import axios from "axios";
+import { BitbucketClient } from "./client.js";
+import { loadConfigFromEnv } from "./config.js";
+import { logger } from "./logger.js";
+import { allModules } from "./handlers/index.js";
+/**
+ * Bitbucket MCP Server with modular handlers
+ */
+export class BitbucketMcpServer {
+    constructor(config) {
+        this.toolHandlers = new Map();
+        this.toolDefinitions = [];
+        this.dangerousToolNames = new Set();
+        this.config = config;
+        this.client = new BitbucketClient(config);
+        this.server = new Server({
+            name: "bitbucket-mcp-server",
+            version: "1.0.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.registerHandlers();
+        this.setupToolRouting();
+        this.server.onerror = (error) => logger.error("[MCP Error]", error);
+    }
+    /**
+     * Register all handler modules
+     */
+    registerHandlers() {
+        for (const module of allModules) {
+            // Collect dangerous tool names
+            if (module.dangerousTools) {
+                for (const name of module.dangerousTools) {
+                    this.dangerousToolNames.add(name);
+                }
+            }
+            // Filter tools based on dangerous flag
+            for (const tool of module.tools) {
+                const isDangerous = this.isDangerousTool(tool.name);
+                if (isDangerous && !this.config.allowDangerousCommands) {
+                    logger.info(`Skipping dangerous tool: ${tool.name}`);
+                    continue;
+                }
+                this.toolDefinitions.push(tool);
+            }
+            // Create handlers
+            const handlers = module.createHandlers(this.client);
+            for (const [name, handler] of Object.entries(handlers)) {
+                const isDangerous = this.isDangerousTool(name);
+                if (isDangerous && !this.config.allowDangerousCommands) {
+                    continue;
+                }
+                this.toolHandlers.set(name, handler);
+            }
+        }
+        logger.info(`Registered ${this.toolDefinitions.length} tools`);
+    }
+    /**
+     * Check if a tool is considered dangerous
+     */
+    isDangerousTool(name) {
+        if (this.dangerousToolNames.has(name))
+            return true;
+        if (/^delete/i.test(name))
+            return true;
+        return false;
+    }
+    /**
+     * Setup MCP tool routing
+     */
+    setupToolRouting() {
+        // List tools handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: this.toolDefinitions,
+        }));
+        // Call tool handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            logger.info(`Tool called: ${name}`, { args });
+            const handler = this.toolHandlers.get(name);
+            if (!handler) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+            try {
+                return await handler(args ?? {});
+            }
+            catch (error) {
+                logger.error("Tool execution error", { error, tool: name });
+                if (axios.isAxiosError(error)) {
+                    throw new McpError(ErrorCode.InternalError, `Bitbucket API error: ${error.response?.data?.message ?? error.message}`);
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Start the server with stdio transport
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        logger.info("Bitbucket MCP server running on stdio");
+    }
+}
+/**
+ * Create and run server from environment config
+ */
+export async function main() {
+    try {
+        const config = loadConfigFromEnv();
+        const server = new BitbucketMcpServer(config);
+        await server.run();
+    }
+    catch (error) {
+        logger.error("Server startup error", { error });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}