Implement Tool to Assign Issues to Contributors #7625

Author: tobiu

ai/mcp/server/github-workflow/openapi.yaml

@@ -409,6 +409,67 @@ paths:
               schema:
                 $ref: '#/components/schemas/ErrorResponse'
 
+  /issues/{issue_number}/assignees:
+    post:
+      summary: Assign an issue to users
+      operationId: assign_issue
+      x-pass-as-object: true
+      x-annotations:
+        readOnlyHint: false
+      description: |
+        Assigns a GitHub issue to one or more users.
+
+        **Permission Required:**
+        This is a restricted action. Before calling this tool, you **must** first use the `get_viewer_permission` tool to verify that you have `ADMIN`, `MAINTAIN`, or `WRITE` permissions.
+      tags: [Issues]
+      parameters:
+        - name: issue_number
+          in: path
+          required: true
+          description: The number of the issue to assign.
+          schema:
+            type: integer
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - assignees
+              properties:
+                assignees:
+                  type: array
+                  items:
+                    type: string
+                  description: An array of GitHub user logins to assign to the issue.
+                  example: ["tobiu", "some-contributor"]
+      responses:
+        '200':
+          description: Issue assigned successfully.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SuccessResponse'
+        '403':
+          description: Forbidden. The user does not have permission to assign issues.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: Issue not found.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: Internal server error, e.g., `gh` command failed.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+
   /issues/{issue_number}/content:
     get:
       summary: Get Local Issue Content by ID

ai/mcp/server/github-workflow/services/IssueService.mjs

@@ -1,16 +1,13 @@
-import Base from '../../../../../src/core/Base.mjs';
-import GraphqlService from './GraphqlService.mjs';
-import aiConfig from '../config.mjs';
-import logger from '../logger.mjs';
-import { spawn } from 'child_process';
-import os from 'os';
-import path from 'path';
-import { promises as fsp } from 'fs';
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { spawn } from 'child_process';
-import { GET_ISSUE_AND_LABEL_IDS } from './queries/issueQueries.mjs';
-import { ADD_LABELS, REMOVE_LABELS } from './queries/mutations.mjs';
+import aiConfig                    from '../config.mjs';
+import Base                        from '../../../../../src/core/Base.mjs';
+import GraphqlService              from './GraphqlService.mjs';
+import logger                      from '../logger.mjs';
+import {exec}                      from 'child_process';
+import {promisify}                 from 'util';
+import {spawn}                     from 'child_process';
+import {GET_ISSUE_AND_LABEL_IDS}   from './queries/issueQueries.mjs';
+import {ADD_LABELS, REMOVE_LABELS} from './queries/mutations.mjs';
+import RepositoryService           from './RepositoryService.mjs';
 
 const execAsync = promisify(exec);
 
@@ -31,7 +28,56 @@ class IssueService extends Base {
          * @member {Boolean} singleton=true
          * @protected
          */
-        singleton: true
+        singleton: true,
+        /**
+         * @member {String[]} writePermissions=['ADMIN', 'MAINTAIN', 'WRITE']
+         * @protected
+         */
+        writePermissions: ['ADMIN', 'MAINTAIN', 'WRITE']
+    }
+
+    /**
+     * Assigns a GitHub issue to one or more users.
+     * @param {object} options
+     * @param {number} options.issue_number
+     * @param {string[]} options.assignees
+     * @returns {Promise<object>}
+     */
+    async assignIssue({issue_number, assignees}) {
+        if (!this.writePermissions.includes(RepositoryService.viewerPermission)) {
+            const message = [
+                `Permission denied. Viewer has '${RepositoryService.viewerPermission}' permission, `,
+                `but one of [${this.writePermissions.join(', ')}] is required to assign issues.`
+            ].join('');
+
+            logger.warn(message);
+            return {
+                error  : 'Permission Denied',
+                message,
+                code   : 'FORBIDDEN'
+            };
+        }
+
+        logger.info(`Attempting to assign issue #${issue_number} to: ${assignees.join(', ')}`);
+
+        try {
+            const assigneeFlags = assignees.map(a => `--add-assignee "${a}"`).join(' ');
+            const command       = `gh issue edit ${issue_number} ${assigneeFlags}`;
+
+            await execAsync(command);
+
+            const message = `Successfully assigned issue #${issue_number} to ${assignees.join(', ')}`;
+            logger.info(message);
+            return { message };
+
+        } catch (error) {
+            logger.error(`Error assigning issue #${issue_number}:`, error);
+            return {
+                error  : 'GitHub CLI command failed',
+                message: error.message,
+                code   : 'GH_CLI_ERROR'
+            };
+        }
     }
 
     /**

ai/mcp/server/github-workflow/services/toolService.mjs

@@ -15,6 +15,7 @@ const openApiFilePath = path.join(__dirname, '../openapi.yaml');
 
 const serviceMapping = {
     add_labels           : IssueService.addLabels.bind(IssueService),
+    assign_issue         : IssueService.assignIssue.bind(IssueService),
     checkout_pull_request: PullRequestService.checkoutPullRequest.bind(PullRequestService),
     create_comment       : PullRequestService.createComment.bind(PullRequestService),
     create_issue         : IssueService.createIssue.bind(IssueService),