MCP GitHub Project Manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:311-358 (handler)

  Main handler function for update_sprint tool. Maps tool arguments to domain model, handles status enum conversion, cleans undefined fields, and delegates to GitHubSprintRepository.update

  async updateSprint(data: {
    sprintId: string;
    title?: string;
    description?: string;
    startDate?: string;
    endDate?: string;
    status?: 'planned' | 'active' | 'completed';
    issues?: string[];
  }): Promise<Sprint> {
    try {
      // Convert status string to ResourceStatus enum if provided
      let resourceStatus: ResourceStatus | undefined;
      if (data.status) {
        switch (data.status) {
          case 'planned':
            resourceStatus = ResourceStatus.PLANNED;
            break;
          case 'active':
            resourceStatus = ResourceStatus.ACTIVE;
            break;
          case 'completed':
            resourceStatus = ResourceStatus.CLOSED;
            break;
        }
      }
  
      // Map input data to domain model
      const sprintData: Partial<Sprint> = {
        title: data.title,
        description: data.description,
        startDate: data.startDate,
        endDate: data.endDate,
        status: resourceStatus,
        issues: data.issues
      };
  
      // Clean up undefined values
      Object.keys(sprintData).forEach(key => {
        if (sprintData[key as keyof Partial<Sprint>] === undefined) {
          delete sprintData[key as keyof Partial<Sprint>];
        }
      });
  
      return await this.sprintRepo.update(data.sprintId, sprintData);
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:766-776 (schema)

  Zod schema definition for update_sprint tool input validation

  // Schema for update_sprint tool
  export const updateSprintSchema = z.object({
    sprintId: z.string().min(1, "Sprint ID is required"),
    title: z.string().optional(),
    description: z.string().optional(),
    startDate: z.string().datetime().optional(),
    endDate: z.string().datetime().optional(),
    status: z.enum(["planned", "active", "completed"]).optional(),
  });
  
  export type UpdateSprintArgs = z.infer<typeof updateSprintSchema>;

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

  Registration of update_sprint tool (as updateSprintTool) in the central ToolRegistry

  this.registerTool(createSprintTool);
  this.registerTool(listSprintsTool);
  this.registerTool(getCurrentSprintTool);
  this.registerTool(updateSprintTool);
  this.registerTool(addIssuesToSprintTool);
  this.registerTool(removeIssuesFromSprintTool);

• src/index.ts:304-305 (registration)

  Dispatch handler in main MCP server that routes update_sprint calls to ProjectManagementService.updateSprint

  case "update_sprint":
    return await this.service.updateSprint(args);

• src/infrastructure/tools/ToolSchemas.ts:1181-1197 (schema)

  ToolDefinition export for update_sprint including name, description, schema reference, and usage examples

  export const updateSprintTool: ToolDefinition<UpdateSprintArgs> = {
    name: "update_sprint",
    description: "Update a development sprint",
    schema: updateSprintSchema as unknown as ToolSchema<UpdateSprintArgs>,
    examples: [
      {
        name: "Update sprint dates",
        description: "Update sprint dates and status",
        args: {
          sprintId: "sprint_1",
          startDate: "2025-07-01T00:00:00Z",
          endDate: "2025-07-15T00:00:00Z",
          status: "active"
        }
      }
    ]
  };