mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:3245-3290 (handler)

  Main handler function that implements the assign_items_to_iteration tool. Finds the iteration field in the project, then bulk assigns the specified item IDs to the given iteration ID by calling setFieldValue for each item.

  async assignItemsToIteration(data: {
    projectId: string;
    itemIds: string[];
    iterationId: string;
    fieldName?: string;
  }): Promise<{ success: boolean; assignedCount: number }> {
    try {
      // Get iteration field
      const fields = await this.listProjectFields({ projectId: data.projectId });
      const iterationField = fields.find((f: CustomField) =>
        f.type === 'iteration' && (!data.fieldName || f.name === data.fieldName)
      );
  
      if (!iterationField) {
        throw new ResourceNotFoundError(
          ResourceType.FIELD,
          data.fieldName || 'iteration field'
        );
      }
  
      let assignedCount = 0;
  
      // Assign each item to the iteration
      for (const itemId of data.itemIds) {
        try {
          await this.setFieldValue({
            projectId: data.projectId,
            itemId: itemId,
            fieldId: iterationField.id,
            value: { iterationId: data.iterationId }
          });
          assignedCount++;
        } catch (error) {
          // Log error but continue with other items
          console.error(`Failed to assign item ${itemId}:`, error);
        }
      }
  
      return {
        success: assignedCount > 0,
        assignedCount
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:2343-2358 (schema)

  Tool definition including name, description, input schema (assignItemsToIterationSchema), and usage examples.

  export const assignItemsToIterationTool: ToolDefinition<AssignItemsToIterationArgs> = {
    name: "assign_items_to_iteration",
    description: "Bulk assign multiple items to a specific iteration",
    schema: assignItemsToIterationSchema as unknown as ToolSchema<AssignItemsToIterationArgs>,
    examples: [
      {
        name: "Assign to sprint",
        description: "Add multiple issues to the current sprint",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          itemIds: ["PVTI_lADOLhQ7gc4AOEbHzM4AOAJ7", "PVTI_lADOLhQ7gc4AOEbHzM4AOAJ8"],
          iterationId: "PVTIF_lADOLhQ7gc4AOEbH"
        }
      }
    ]
  };

• src/infrastructure/tools/ToolSchemas.ts:1375-1383 (schema)

  Zod input validation schema defining parameters: projectId, itemIds (array), iterationId, optional fieldName.

  // Schema for assign_items_to_iteration tool
  export const assignItemsToIterationSchema = z.object({
    projectId: z.string().min(1, "Project ID is required"),
    itemIds: z.array(z.string()).min(1, "At least one item ID is required"),
    iterationId: z.string().min(1, "Iteration ID is required"),
    fieldName: z.string().optional()
  });
  
  export type AssignItemsToIterationArgs = z.infer<typeof assignItemsToIterationSchema>;

• src/infrastructure/tools/ToolRegistry.ts:292-292 (registration)

  Registers the assignItemsToIterationTool in the central ToolRegistry singleton.

  this.registerTool(assignItemsToIterationTool);

• src/infrastructure/tools/ToolRegistry.ts:108-108 (registration)

  Imports assignItemsToIterationTool from ToolSchemas.ts for registration.

  assignItemsToIterationTool,

• src/index.ts:500-501 (handler)

  MCP server dispatch: routes tool calls to ProjectManagementService.assignItemsToIteration.

  case "assign_items_to_iteration":
    return await this.service.assignItemsToIteration(args);