@stubbedev/atlassian-mcp 0.1.0 → 0.1.4

package/README.md

@@ -38,16 +38,16 @@ A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **s
 | `bitbucket_list_pull_requests` | List repository pull requests (filter by state, source branch, or text) |
 | `bitbucket_my_prs` | List PRs in your inbox (authored by you or awaiting review) |
 | `bitbucket_get_pull_request` | Get pull request details |
-| `bitbucket_get_pr_overview` | Get a one-call PR overview: metadata, commits, comments/blockers, and optional diff |
+| `bitbucket_get_pr_overview` | Get a one-call PR overview: metadata, commits, comments, task-style BLOCKER comments, and optional diff |
 | `bitbucket_get_pr_diff` | Get the code diff for a pull request |
 | `bitbucket_create_pull_request` | Create a new pull request |
 | `bitbucket_approve_pr` | Approve a pull request |
 | `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 PR comment threads in bulk, including blocker comments and blocker counts |
+| `bitbucket_get_pr_comments` | Get PR comment threads in bulk, including task-style BLOCKER comments and blocker 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_update_pr_comment` | Update comment text, state, or severity (`BLOCKER` = task/checklist item) |
 | `bitbucket_delete_pr_comment` | Delete a PR comment by comment ID |
 | `bitbucket_get_pr_commits` | List commits included in a pull request |
 | `bitbucket_get_branches` | List branches in a repository |

package/dist/bitbucket.js

@@ -1,4 +1,5 @@
 import { execSync } from 'child_process';
+const EMOJI_RE = /\p{Extended_Pictographic}/u;
 function safeExec(cmd) {
     try {
         return execSync(cmd, { encoding: 'utf-8' }).trim();
@@ -136,6 +137,16 @@ function formatBitbucketError(status, method, path, details) {
         return `${prefix}. Conflict (often stale version/state). Refresh and retry. ${details}`.trim();
     return details ? `${prefix}. ${details}` : prefix;
 }
+function validateCommentText(textValue) {
+    const trimmed = textValue.trim();
+    if (!trimmed) {
+        throw new Error('Bitbucket comment text must not be empty.');
+    }
+    if (EMOJI_RE.test(trimmed)) {
+        throw new Error('Bitbucket comments must not include emoji. Use concise plain text only.');
+    }
+    return trimmed;
+}
 export class BitbucketClient {
     baseUrl;
     headers;
@@ -510,7 +521,7 @@ export class BitbucketClient {
     }
     async addPrComment(args) {
         const { projectKey, repoSlug } = this.resolveProjectAndRepo(args.projectKey, args.repoSlug);
-        const body = { text: args.text };
+        const body = { text: validateCommentText(args.text) };
         if (args.parentCommentId)
             body.parent = { id: args.parentCommentId };
         const created = await this.request('POST', `/projects/${projectKey}/repos/${repoSlug}/pull-requests/${args.prId}/comments`, body);
@@ -531,7 +542,7 @@ export class BitbucketClient {
             throw new Error(`Comment #${args.commentId} not found.`);
         const body = {
             version: current.version,
-            text: args.text ?? current.text,
+            text: args.text !== undefined ? validateCommentText(args.text) : current.text,
         };
         if (args.state)
             body.state = args.state;

package/dist/index.js

@@ -162,12 +162,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'jira_add_comment',
-            description: 'Use when you want to leave a comment on a Jira ticket.',
+            description: 'Use when you want to leave a comment on a Jira ticket. Keep comments concise, plain text, and free of filler. Never include emojis.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     issueKey: { type: 'string', description: 'Jira issue key' },
-                    body: { type: 'string', description: 'Comment text (plain text or Jira wiki markup)' },
+                    body: { type: 'string', description: 'Concise comment text only. No filler. Do not include emojis.' },
                 },
                 required: ['issueKey', 'body'],
             },
@@ -246,7 +246,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_get_pr_overview',
-            description: 'Use when you want one bulk PR snapshot in a single call: metadata, commits, comments/blockers, and optional diff.',
+            description: 'Use when you want one bulk PR snapshot in a single call: metadata, commits, comments, task-style BLOCKER comments, and optional diff.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -259,7 +259,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     includeComments: { type: 'boolean', description: 'Include review comments/blockers (default true)', default: true },
                     includeDiff: { type: 'boolean', description: 'Include diff text (default false)', default: false },
                     commentsState: { type: 'string', enum: ['OPEN', 'RESOLVED', 'PENDING'], description: 'Comment state filter (default OPEN)', default: 'OPEN' },
-                    commentsSeverity: { type: 'string', enum: ['ALL', 'NORMAL', 'BLOCKER'], description: 'Comment severity filter (default ALL)', default: 'ALL' },
+                    commentsSeverity: { type: 'string', enum: ['ALL', 'NORMAL', 'BLOCKER'], description: 'Comment severity filter (default ALL). BLOCKER means task/checklist-style review comments.', default: 'ALL' },
                     commentsLimit: { type: 'number', description: 'Max comments per page (default 50)', default: 50 },
                     commentsStart: { type: 'number', description: 'Comment pagination offset (default 0)', default: 0 },
                     commitsLimit: { type: 'number', description: 'Max commits per page (default 25)', default: 25 },
@@ -385,7 +385,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_get_pr_comments',
-            description: 'Use when you want PR review discussion in bulk: comment threads, blocker comments, and blocker counts with pagination. You can pass projectKey/repoSlug or project/repo.',
+            description: 'Use when you want PR review discussion in bulk: comment threads, task-style BLOCKER comments, and blocker counts with pagination. You can pass projectKey/repoSlug or project/repo.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -396,7 +396,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     prId: { type: 'number', description: 'Pull request number (PR ID)' },
                     path: { type: 'string', description: 'Optional file path filter, e.g. "src/index.ts"' },
                     state: { type: 'string', enum: ['OPEN', 'RESOLVED', 'PENDING'], description: 'Comment state filter (default OPEN; BLOCKER mode supports OPEN/RESOLVED)', default: 'OPEN' },
-                    severity: { type: 'string', enum: ['ALL', 'NORMAL', 'BLOCKER'], description: 'Comment severity filter. Use BLOCKER for blocker comments.', default: 'ALL' },
+                    severity: { type: 'string', enum: ['ALL', 'NORMAL', 'BLOCKER'], description: 'Comment severity filter. BLOCKER means task/checklist-style review comments.', default: 'ALL' },
                     countOnly: { type: 'boolean', description: 'When true with severity=BLOCKER, returns counts instead of comment bodies', default: false },
                     limit: { type: 'number', description: 'Max items per page (default 50)', default: 50 },
                     start: { type: 'number', description: 'Offset for pagination (default 0)', default: 0 },
@@ -406,7 +406,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'bitbucket_add_pr_comment',
-            description: 'Use when you want to add a PR review comment or reply to an existing thread. You can pass projectKey/repoSlug or project/repo.',
+            description: 'Use when you want to add a PR review comment or reply to an existing thread. Keep comments concise, plain text, and free of filler. Never include emojis. You can pass projectKey/repoSlug or project/repo.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -416,14 +416,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     repo: { type: 'string', description: 'Alias for repoSlug' },
                     prId: { type: 'number', description: 'Pull request number (PR ID)' },
                     parentCommentId: { type: 'number', description: 'Parent comment ID for reply mode (optional)' },
-                    text: { type: 'string', description: 'Comment text' },
+                    text: { type: 'string', description: 'Concise comment text only. No filler. Do not include emojis.' },
                 },
                 required: ['prId', 'text'],
             },
         },
         {
             name: 'bitbucket_update_pr_comment',
-            description: 'Use when you want to edit PR comments, resolve/reopen them, or set severity to BLOCKER. You can pass projectKey/repoSlug or project/repo.',
+            description: 'Use when you want to edit PR comments, resolve/reopen them, or mark comments as task-style BLOCKER items. Keep comments concise, plain text, and free of filler. Never include emojis. You can pass projectKey/repoSlug or project/repo.',
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -433,9 +433,9 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     repo: { type: 'string', description: 'Alias for repoSlug' },
                     prId: { type: 'number', description: 'Pull request number (PR ID)' },
                     commentId: { type: 'number', description: 'Comment ID to update' },
-                    text: { type: 'string', description: 'New comment text (optional)' },
+                    text: { type: 'string', description: 'New concise comment text only. No filler. Do not include emojis. (optional)' },
                     state: { type: 'string', enum: ['OPEN', 'RESOLVED'], description: 'Comment state (optional)' },
-                    severity: { type: 'string', enum: ['NORMAL', 'BLOCKER'], description: 'Comment severity (optional)' },
+                    severity: { type: 'string', enum: ['NORMAL', 'BLOCKER'], description: 'Comment severity (optional). BLOCKER marks it as a task/checklist item.' },
                 },
                 required: ['prId', 'commentId'],
             },

package/dist/jira.js

@@ -1,5 +1,6 @@
 import { execSync } from 'child_process';
 const JIRA_KEY_IN_BRANCH_RE = /\b([A-Z][A-Z0-9]+)-\d+\b/;
+const EMOJI_RE = /\p{Extended_Pictographic}/u;
 function text(t) {
     return { content: [{ type: 'text', text: t }] };
 }
@@ -76,6 +77,16 @@ function formatJiraError(status, method, path, details) {
         return `${prefix}. Conflict. Refresh and retry. ${details}`.trim();
     return details ? `${prefix}. ${details}` : prefix;
 }
+function validateCommentBody(body) {
+    const trimmed = body.trim();
+    if (!trimmed) {
+        throw new Error('Jira comment body must not be empty.');
+    }
+    if (EMOJI_RE.test(trimmed)) {
+        throw new Error('Jira comments must not include emoji. Use concise plain text only.');
+    }
+    return trimmed;
+}
 export class JiraClient {
     baseUrl;
     headers;
@@ -246,7 +257,7 @@ export class JiraClient {
         return text(`${data.total} comment(s) on ${issueKey}${page}:\n\n${blocks.join('\n\n')}`);
     }
     async addComment(args) {
-        await this.request('POST', `/issue/${args.issueKey}/comment`, { body: args.body });
+        await this.request('POST', `/issue/${args.issueKey}/comment`, { body: validateCommentBody(args.body) });
         return text(`Comment added to ${args.issueKey}.`);
     }
     async transitionIssue(args) {

package/package.json

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