@stubbedev/atlassian-mcp 0.0.4 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # atlassian-mcp
 
-A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **self-hosted Jira** (Server / Data Center) and **self-hosted Bitbucket** (Server / Data Center). Exposes 34 tools to Claude for reading and managing issues, pull requests, comments, and git context.
+A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **self-hosted Jira** (Server / Data Center) and **self-hosted Bitbucket** (Server / Data Center). Exposes 37 tools to Claude for reading and managing issues, pull requests, comments, and git context.
 
 > **Note:** This server only supports self-hosted instances. Jira Cloud and Bitbucket Cloud use different APIs and are not supported.
 
@@ -46,7 +46,9 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 | `bitbucket_unapprove_pr` | Remove your approval from a pull request |
 | `bitbucket_merge_pr` | Merge a pull request |
 | `bitbucket_decline_pr` | Decline a pull request |
-| `bitbucket_get_pr_comments` | Get comment threads with IDs and states for a pull request |
+| `bitbucket_get_pr_comments` | Get PR comment threads with IDs/states (optional `path` filter) |
+| `bitbucket_get_pr_tasks` | List PR tasks (blocker comments), with `OPEN`/`RESOLVED` filter |
+| `bitbucket_get_pr_task_count` | Get total OPEN and RESOLVED PR task counts |
 | `bitbucket_add_pr_comment` | Add a top-level PR comment or reply to an existing comment |
 | `bitbucket_update_pr_comment` | Update comment text, state, or severity (`NORMAL` / `BLOCKER`) |
 | `bitbucket_delete_pr_comment` | Delete a PR comment by comment ID |

package/dist/bitbucket.js

@@ -49,6 +49,21 @@ function formatCommentThread(comment, indent = '') {
     }
     return lines;
 }
+function commentMatchesState(comment, state) {
+    const currentState = comment.state ?? 'OPEN';
+    if (currentState === state)
+        return true;
+    return (comment.comments ?? []).some((child) => commentMatchesState(child, state));
+}
+function uniqueCommentsFromActivities(activities) {
+    const byId = new Map();
+    for (const activity of activities) {
+        if (activity.action === 'COMMENTED' && activity.comment && !byId.has(activity.comment.id)) {
+            byId.set(activity.comment.id, activity.comment);
+        }
+    }
+    return Array.from(byId.values()).sort((a, b) => (a.createdDate ?? 0) - (b.createdDate ?? 0));
+}
 function pageHint(data) {
     return data.isLastPage ? '' : ` (use start=${data.nextPageStart} for next page)`;
 }
@@ -153,8 +168,11 @@ export class BitbucketClient {
         return text(`${data.values.length} PR(s) (${state})${pageHint(data)}:\n${lines.join('\n')}`);
     }
     async myPrs(args) {
-        const { limit = 25, start = 0 } = args;
-        const data = await this.request('GET', `/inbox/pull-requests?limit=${limit}&start=${start}`);
+        const { limit = 25, start = 0, role } = args;
+        const qs = new URLSearchParams({ limit: String(limit), start: String(start) });
+        if (role)
+            qs.set('role', role);
+        const data = await this.request('GET', `/inbox/pull-requests?${qs}`);
         if (!data || data.values.length === 0)
             return text('No pull requests in your inbox.');
         const lines = data.values.map((pr) => {
@@ -193,7 +211,8 @@ export class BitbucketClient {
     async getPrCommits(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
         const limit = args.limit ?? 25;
-        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/commits?limit=${limit}`);
+        const start = args.start ?? 0;
+        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/commits?limit=${limit}&start=${start}`);
         if (!data || data.values.length === 0)
             return text('No commits found.');
         const lines = data.values.map((c) => `${c.displayId} ${formatDate(c.authorTimestamp)} ${c.author.name}: ${c.message.split('\n')[0]}`);
@@ -280,14 +299,56 @@ export class BitbucketClient {
     async getPrComments(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
         const { limit = 50, start = 0, state = 'OPEN' } = args;
-        const qs = new URLSearchParams({ limit: String(limit), start: String(start) });
-        qs.set('state', state);
-        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/comments?${qs}`);
-        if (!data || data.values.length === 0) {
+        if (args.path) {
+            const qs = new URLSearchParams({
+                limit: String(limit),
+                start: String(start),
+                state,
+                path: args.path,
+            });
+            const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/comments?${qs}`);
+            const filtered = (data?.values ?? []).filter((comment) => commentMatchesState(comment, state));
+            if (filtered.length === 0) {
+                return text(`No ${state} comments on PR #${args.prId} for path ${args.path}.`);
+            }
+            const blocks = filtered.flatMap((comment) => formatCommentThread(comment));
+            const paging = data ? pageHint(data) : '';
+            return text(`${filtered.length} comment thread(s) on PR #${args.prId} for ${args.path}${paging}:\n\n${blocks.join('\n\n')}`);
+        }
+        const activityData = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/activities?limit=${limit}&start=${start}`);
+        const comments = uniqueCommentsFromActivities(activityData?.values ?? []).filter((comment) => commentMatchesState(comment, state));
+        if (comments.length === 0) {
             return text(`No ${state} comments on PR #${args.prId}.`);
         }
+        const blocks = comments.flatMap((comment) => formatCommentThread(comment));
+        const paging = activityData ? pageHint(activityData) : '';
+        return text(`${comments.length} comment thread(s) on PR #${args.prId}${paging}:\n\n${blocks.join('\n\n')}`);
+    }
+    async getPrTasks(args) {
+        const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        const { limit = 50, start = 0, state = 'OPEN' } = args;
+        const qs = new URLSearchParams({ limit: String(limit), start: String(start), state });
+        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/blocker-comments?${qs}`);
+        if (!data || data.values.length === 0) {
+            return text(`No ${state} tasks on PR #${args.prId}.`);
+        }
         const blocks = data.values.flatMap((comment) => formatCommentThread(comment));
-        return text(`${data.values.length} comment thread(s) on PR #${args.prId}${pageHint(data)}:\n\n${blocks.join('\n\n')}`);
+        return text(`${data.values.length} ${state} task(s) on PR #${args.prId}${pageHint(data)}:\n\n${blocks.join('\n\n')}`);
+    }
+    async getPrTaskCount(args) {
+        const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
+        const data = await this.request('GET', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/blocker-comments?count=true`);
+        let open = data?.open ?? 0;
+        let resolved = data?.resolved ?? 0;
+        if ((open === 0 && resolved === 0) && data?.values && data.values.length > 0) {
+            for (const v of data.values) {
+                if ((v.state ?? '').toUpperCase() === 'OPEN')
+                    open = v.count ?? open;
+                if ((v.state ?? '').toUpperCase() === 'RESOLVED')
+                    resolved = v.count ?? resolved;
+            }
+        }
+        return text(`PR #${args.prId} tasks: OPEN=${open}, RESOLVED=${resolved}`);
     }
     async addPrComment(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);

package/dist/index.js

@@ -228,6 +228,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 properties: {
                     limit: { type: 'number', description: 'Max PRs per page (default 25)', default: 25 },
                     start: { type: 'number', description: 'Offset for pagination (default 0)', default: 0 },
+                    role: { type: 'string', enum: ['author', 'reviewer', 'participant'], description: 'Inbox role filter (default server behavior)' },
                 },
             },
         },
@@ -267,6 +268,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     repoSlug: { type: 'string', description: 'Repository slug (auto-detected from git remote if omitted)' },
                     prId: { type: 'number', description: 'Pull request ID' },
                     limit: { type: 'number', description: 'Max commits (default 25)', default: 25 },
+                    start: { type: 'number', description: 'Offset for pagination (default 0)', default: 0 },
                 },
                 required: ['prId'],
             },
@@ -345,13 +347,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_get_pr_comments',
-            description: 'Get pull request comment threads with comment IDs and states (needed for replies and resolving)',
+            description: 'Get pull request comment threads with comment IDs and states (uses activities feed unless a path filter is provided)',
             inputSchema: {
                 type: 'object',
                 properties: {
                     projectKey: { type: 'string', description: 'Bitbucket project key (auto-detected from git remote if omitted)' },
                     repoSlug: { type: 'string', description: 'Repository slug (auto-detected from git remote if omitted)' },
                     prId: { type: 'number', description: 'Pull request ID' },
+                    path: { type: 'string', description: 'Optional file path filter, e.g. "src/index.ts"' },
                     state: { type: 'string', enum: ['OPEN', 'RESOLVED', 'PENDING'], description: 'Filter comment state (default OPEN)', default: 'OPEN' },
                     limit: { type: 'number', description: 'Max items per page (default 50)', default: 50 },
                     start: { type: 'number', description: 'Offset for pagination (default 0)', default: 0 },
@@ -359,6 +362,35 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ['prId'],
             },
         },
+        {
+            name: 'bitbucket_get_pr_tasks',
+            description: 'List blocker comments (tasks) on a pull request',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectKey: { type: 'string', description: 'Bitbucket project key (auto-detected from git remote if omitted)' },
+                    repoSlug: { type: 'string', description: 'Repository slug (auto-detected from git remote if omitted)' },
+                    prId: { type: 'number', description: 'Pull request ID' },
+                    state: { type: 'string', enum: ['OPEN', 'RESOLVED'], description: 'Task state filter (default OPEN)', default: 'OPEN' },
+                    limit: { type: 'number', description: 'Max tasks per page (default 50)', default: 50 },
+                    start: { type: 'number', description: 'Offset for pagination (default 0)', default: 0 },
+                },
+                required: ['prId'],
+            },
+        },
+        {
+            name: 'bitbucket_get_pr_task_count',
+            description: 'Get total OPEN and RESOLVED task counts for a pull request',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    projectKey: { type: 'string', description: 'Bitbucket project key (auto-detected from git remote if omitted)' },
+                    repoSlug: { type: 'string', description: 'Repository slug (auto-detected from git remote if omitted)' },
+                    prId: { type: 'number', description: 'Pull request ID' },
+                },
+                required: ['prId'],
+            },
+        },
         {
             name: 'bitbucket_add_pr_comment',
             description: 'Add a top-level comment or reply to an existing comment in a pull request',
@@ -530,6 +562,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return await bitbucket.mergePr(args);
             case 'bitbucket_get_pr_comments':
                 return await bitbucket.getPrComments(args);
+            case 'bitbucket_get_pr_tasks':
+                return await bitbucket.getPrTasks(args);
+            case 'bitbucket_get_pr_task_count':
+                return await bitbucket.getPrTaskCount(args);
             case 'bitbucket_add_pr_comment':
                 return await bitbucket.addPrComment(args);
             case 'bitbucket_update_pr_comment':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "type": "module",
   "main": "dist/index.js",