@atlassian-dc-mcp/bitbucket 0.9.8 → 0.9.10

package/src/bitbucket-service.ts

@@ -99,6 +99,73 @@ export class BitbucketService {
     );
   }
 
+  /**
+   * Get pull requests for a repository
+   * @param projectKey The project key
+   * @param repositorySlug The repository slug
+   * @param withAttributes Optional flag to return additional pull request attributes (default: true)
+   * @param at Optional fully-qualified branch ID to find pull requests to or from (e.g., refs/heads/master)
+   * @param withProperties Optional flag to return additional pull request properties (default: true)
+   * @param draft Optional draft status filter
+   * @param filterText Optional text filter for title or description
+   * @param state Optional state filter (OPEN, DECLINED, MERGED, or ALL; default: OPEN)
+   * @param order Optional order (NEWEST or OLDEST; default: NEWEST)
+   * @param direction Optional direction relative to repository (INCOMING or OUTGOING; default: INCOMING)
+   * @param start Optional pagination start
+   * @param limit Optional pagination limit (default: 25)
+   * @returns Promise with pull requests data
+   */
+  async getPullRequests(
+    projectKey: string,
+    repositorySlug: string,
+    withAttributes?: string,
+    at?: string,
+    withProperties?: string,
+    draft?: string,
+    filterText?: string,
+    state?: string,
+    order?: string,
+    direction?: string,
+    start?: number,
+    limit: number = 25
+  ) {
+    return handleApiOperation(
+      () => PullRequestsService.getPage(
+        projectKey,
+        repositorySlug,
+        withAttributes,
+        at,
+        withProperties,
+        draft,
+        filterText,
+        state,
+        order,
+        direction,
+        start,
+        limit
+      ),
+      'Error fetching pull requests'
+    );
+  }
+
+  /**
+   * Get a specific pull request by ID
+   * @param projectKey The project key
+   * @param repositorySlug The repository slug
+   * @param pullRequestId The ID of the pull request within the repository
+   * @returns Promise with pull request data
+   */
+  async getPullRequest(
+    projectKey: string,
+    repositorySlug: string,
+    pullRequestId: string
+  ) {
+    return handleApiOperation(
+      () => PullRequestsService.get3(projectKey, pullRequestId, repositorySlug),
+      'Error fetching pull request'
+    );
+  }
+
   async getPullRequestCommentsAndActions(projectKey: string, repositorySlug: string, pullRequestId: string, start?: number,
     limit: number = 25
   ) {
@@ -293,6 +360,142 @@ export class BitbucketService {
     );
   }
 
+  /**
+   * Create a pull request
+   * @param projectKey The project key
+   * @param repositorySlug The repository slug
+   * @param title The pull request title
+   * @param description Optional pull request description
+   * @param fromRefId The source branch (e.g., 'refs/heads/feature-branch')
+   * @param toRefId The destination branch (e.g., 'refs/heads/main')
+   * @param reviewers Optional array of reviewer usernames
+   * @returns Promise with created pull request data
+   */
+  async createPullRequest(
+    projectKey: string,
+    repositorySlug: string,
+    title: string,
+    description: string | undefined,
+    fromRefId: string,
+    toRefId: string,
+    reviewers?: string[]
+  ) {
+    const pullRequestData: any = {
+      title,
+      description,
+      fromRef: {
+        id: fromRefId,
+        repository: {
+          slug: repositorySlug,
+          project: {
+            key: projectKey
+          }
+        }
+      },
+      toRef: {
+        id: toRefId,
+        repository: {
+          slug: repositorySlug,
+          project: {
+            key: projectKey
+          }
+        }
+      }
+    };
+
+    if (reviewers && reviewers.length > 0) {
+      pullRequestData.reviewers = reviewers.map(username => ({
+        user: {
+          name: username
+        }
+      }));
+    }
+
+    return handleApiOperation(
+      () => PullRequestsService.create(projectKey, repositorySlug, pullRequestData),
+      'Error creating pull request'
+    );
+  }
+
+  /**
+   * Update a pull request
+   * @param projectKey The project key
+   * @param repositorySlug The repository slug
+   * @param pullRequestId The pull request ID
+   * @param version The version of the pull request (required for optimistic locking)
+   * @param title Optional new title for the pull request
+   * @param description Optional new description for the pull request
+   * @param reviewers Optional array of reviewer usernames to set
+   * @returns Promise with updated pull request data
+   */
+  async updatePullRequest(
+    projectKey: string,
+    repositorySlug: string,
+    pullRequestId: string,
+    version: number,
+    title?: string,
+    description?: string,
+    reviewers?: string[]
+  ) {
+    const pullRequestData: any = {
+      version
+    };
+
+    if (title !== undefined) {
+      pullRequestData.title = title;
+    }
+
+    if (description !== undefined) {
+      pullRequestData.description = description;
+    }
+
+    if (reviewers && reviewers.length > 0) {
+      pullRequestData.reviewers = reviewers.map(username => ({
+        user: {
+          name: username
+        }
+      }));
+    }
+
+    return handleApiOperation(
+      () => PullRequestsService.update(projectKey, pullRequestId, repositorySlug, pullRequestData),
+      'Error updating pull request'
+    );
+  }
+
+  /**
+   * Get required reviewers for PR creation
+   * Returns a set of users who are required reviewers for pull requests created from the given source repository
+   * and ref to the given target ref in this repository.
+   * @param projectKey The project key
+   * @param repositorySlug The repository slug
+   * @param sourceRefId The ID of the source ref (e.g., 'refs/heads/feature-branch')
+   * @param targetRefId The ID of the target ref (e.g., 'refs/heads/main')
+   * @param sourceRepoId Optional ID of the repository in which the source ref exists
+   * @param targetRepoId Optional ID of the repository in which the target ref exists
+   * @returns Promise with required reviewers data
+   */
+  async getRequiredReviewers(
+    projectKey: string,
+    repositorySlug: string,
+    sourceRefId: string,
+    targetRefId: string,
+    sourceRepoId?: string,
+    targetRepoId?: string
+  ) {
+    return handleApiOperation(
+      () => PullRequestsService.getReviewers(
+        projectKey,
+        repositorySlug,
+        targetRepoId,
+        sourceRepoId,
+        sourceRefId,
+        targetRefId
+      ),
+      'Error fetching required reviewers'
+    );
+  }
+
   static validateConfig(): string[] {
     // Check for BITBUCKET_HOST or its alternative BITBUCKET_API_BASE_PATH
     const requiredEnvVars = ['BITBUCKET_API_TOKEN'] as const;
@@ -314,6 +517,25 @@ export const bitbucketToolSchemas = {
     start: z.number().optional().describe("Start number for pagination"),
     limit: z.number().optional().default(25).describe("Number of items to return")
   },
+  getPullRequests: {
+    projectKey: z.string().describe("The project key"),
+    repositorySlug: z.string().describe("The repository slug"),
+    withAttributes: z.string().optional().describe("(optional) defaults to true, whether to return additional pull request attributes"),
+    at: z.string().optional().describe("(optional) a fully-qualified branch ID to find pull requests to or from, such as refs/heads/master"),
+    withProperties: z.string().optional().describe("(optional) defaults to true, whether to return additional pull request properties"),
+    draft: z.string().optional().describe("(optional) If specified, only pull requests matching the supplied draft status will be returned"),
+    filterText: z.string().optional().describe("(optional) If specified, only pull requests where the title or description contains the supplied string will be returned"),
+    state: z.string().optional().describe("(optional, defaults to OPEN). Supply ALL to return pull request in any state. If a state is supplied only pull requests in the specified state will be returned. Either OPEN, DECLINED or MERGED"),
+    order: z.string().optional().describe("(optional, defaults to NEWEST) the order to return pull requests in, either OLDEST (as in: \"oldest first\") or NEWEST"),
+    direction: z.string().optional().describe("(optional, defaults to INCOMING) the direction relative to the specified repository. Either INCOMING or OUTGOING"),
+    start: z.number().optional().describe("Start number for the page (inclusive). If not passed, first page is assumed"),
+    limit: z.number().optional().default(25).describe("Number of items to return. If not passed, a page size of 25 is used")
+  },
+  getPullRequest: {
+    projectKey: z.string().describe("The project key"),
+    repositorySlug: z.string().describe("The repository slug"),
+    pullRequestId: z.string().describe("The ID of the pull request within the repository")
+  },
   getProject: {
     projectKey: z.string().describe("The project key")
   },
@@ -373,5 +595,31 @@ export const bitbucketToolSchemas = {
     diffType: z.string().optional().describe("The type of diff being requested"),
     untilId: z.string().optional().describe("The until commit hash to stream a diff between two arbitrary hashes"),
     whitespace: z.string().optional().describe("Optional whitespace flag which can be set to 'ignore-all'")
+  },
+  createPullRequest: {
+    projectKey: z.string().describe("The project key"),
+    repositorySlug: z.string().describe("The repository slug"),
+    title: z.string().describe("The pull request title"),
+    description: z.string().optional().describe("The pull request description"),
+    fromRefId: z.string().describe("The source branch reference ID (e.g., 'refs/heads/feature-branch')"),
+    toRefId: z.string().describe("The destination branch reference ID (e.g., 'refs/heads/main')"),
+    reviewers: z.array(z.string()).optional().describe("Optional array of reviewer usernames")
+  },
+  updatePullRequest: {
+    projectKey: z.string().describe("The project key"),
+    repositorySlug: z.string().describe("The repository slug"),
+    pullRequestId: z.string().describe("The pull request ID"),
+    version: z.number().describe("The current version of the pull request (required for optimistic locking)"),
+    title: z.string().optional().describe("The new title for the pull request"),
+    description: z.string().optional().describe("The new description for the pull request"),
+    reviewers: z.array(z.string()).optional().describe("Optional array of reviewer usernames to set")
+  },
+  getRequiredReviewers: {
+    projectKey: z.string().describe("The project key"),
+    repositorySlug: z.string().describe("The repository slug"),
+    sourceRefId: z.string().describe("The ID of the source ref (e.g., 'refs/heads/feature-branch')"),
+    targetRefId: z.string().describe("The ID of the target ref (e.g., 'refs/heads/main')"),
+    sourceRepoId: z.string().optional().describe("Optional ID of the repository in which the source ref exists"),
+    targetRepoId: z.string().optional().describe("Optional ID of the repository in which the target ref exists")
   }
 };

package/src/index.ts

@@ -72,6 +72,26 @@ server.tool(
   }
 );
 
+server.tool(
+  "bitbucket_getPullRequests",
+  "Get pull requests for a Bitbucket repository",
+  bitbucketToolSchemas.getPullRequests,
+  async ({ projectKey, repositorySlug, withAttributes, at, withProperties, draft, filterText, state, order, direction, start, limit }) => {
+    const result = await bitbucketService.getPullRequests(projectKey, repositorySlug, withAttributes, at, withProperties, draft, filterText, state, order, direction, start, limit);
+    return formatToolResponse(result);
+  }
+);
+
+server.tool(
+  "bitbucket_getPullRequest",
+  "Get a specific pull request by ID. Returns full details including title, description, reviewers, participants, author, source/target branches, and current state.",
+  bitbucketToolSchemas.getPullRequest,
+  async ({ projectKey, repositorySlug, pullRequestId }) => {
+    const result = await bitbucketService.getPullRequest(projectKey, repositorySlug, pullRequestId);
+    return formatToolResponse(result);
+  }
+);
+
 server.tool(
   "bitbucket_getPR_CommentsAndAction",
   "Get comments for a Bitbucket pull request and other actions, like approvals",
@@ -113,4 +133,34 @@ server.tool(
   }
 );
 
+server.tool(
+  "bitbucket_createPullRequest",
+  "Create a new pull request in a Bitbucket repository. IMPORTANT: Before creating a PR, use bitbucket_getRequiredReviewers to fetch required reviewers for the source and target branches to ensure the PR is not created without mandatory reviewers.",
+  bitbucketToolSchemas.createPullRequest,
+  async ({ projectKey, repositorySlug, title, description, fromRefId, toRefId, reviewers }) => {
+    const result = await bitbucketService.createPullRequest(projectKey, repositorySlug, title, description, fromRefId, toRefId, reviewers);
+    return formatToolResponse(result);
+  }
+);
+
+server.tool(
+  "bitbucket_updatePullRequest",
+  "Update the title, description, reviewers, destination branch or draft status of an existing pull request. IMPORTANT: The reviewers parameter replaces ALL existing reviewers. If you want to preserve existing reviewers, first fetch the current PR details (using bitbucket_getPullRequests filtered by ID) and include those reviewers along with any new ones you want to add.",
+  bitbucketToolSchemas.updatePullRequest,
+  async ({ projectKey, repositorySlug, pullRequestId, version, title, description, reviewers }) => {
+    const result = await bitbucketService.updatePullRequest(projectKey, repositorySlug, pullRequestId, version, title, description, reviewers);
+    return formatToolResponse(result);
+  }
+);
+
+server.tool(
+  "bitbucket_getRequiredReviewers",
+  "Get required reviewers for pull request creation. Returns a set of users who are required reviewers for pull requests created from the given source repository and ref to the given target ref in this repository.",
+  bitbucketToolSchemas.getRequiredReviewers,
+  async ({ projectKey, repositorySlug, sourceRefId, targetRefId, sourceRepoId, targetRepoId }) => {
+    const result = await bitbucketService.getRequiredReviewers(projectKey, repositorySlug, sourceRefId, targetRefId, sourceRepoId, targetRepoId);
+    return formatToolResponse(result);
+  }
+);
+
 await connectServer(server);