MCP GitHub Project Manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:1860-1893 (handler)

  Primary handler for update_milestone tool: validates input, maps to domain model, calls repository to update GitHub milestone

  async updateMilestone(data: {
    milestoneId: string;
    title?: string;
    description?: string;
    dueDate?: string | null;
    state?: 'open' | 'closed';
  }): Promise<Milestone> {
    try {
      // Convert state to ResourceStatus if provided
      let status: ResourceStatus | undefined;
      if (data.state) {
        status = data.state === 'open' ? ResourceStatus.ACTIVE : ResourceStatus.CLOSED;
      }
  
      // Map input data to domain model
      const milestoneData: Partial<Milestone> = {
        title: data.title,
        description: data.description,
        dueDate: data.dueDate === null ? undefined : data.dueDate,
        status
      };
  
      // Clean up undefined values
      Object.keys(milestoneData).forEach(key => {
        if (milestoneData[key as keyof Partial<Milestone>] === undefined) {
          delete milestoneData[key as keyof Partial<Milestone>];
        }
      });
  
      return await this.milestoneRepo.update(data.milestoneId, milestoneData);
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/github/repositories/GitHubMilestoneRepository.ts:116-130 (handler)

  Core implementation: calls GitHub REST API octokit.rest.issues.updateMilestone to perform the actual update

  async update(id: MilestoneId, data: Partial<Milestone>): Promise<Milestone> {
    // Use REST API for milestone updates since GraphQL doesn't support it
    const response = await this.rest(
      (params) => this.octokit.rest.issues.updateMilestone(params),
      {
        milestone_number: parseInt(id),
        title: data.title,
        description: data.description,
        due_on: data.dueDate,
        state: data.status === ResourceStatus.CLOSED ? "closed" : "open",
      }
    );
  
    return this.mapRestMilestoneToMilestone(response);
  }

• src/infrastructure/tools/ToolSchemas.ts:748-757 (schema)

  Zod input schema validation for update_milestone tool

  // Schema for update_milestone tool
  export const updateMilestoneSchema = z.object({
    milestoneId: z.string().min(1, "Milestone ID is required"),
    title: z.string().optional(),
    description: z.string().optional(),
    dueDate: z.string().datetime().optional().nullable(),
    state: z.enum(["open", "closed"]).optional(),
  });
  
  export type UpdateMilestoneArgs = z.infer<typeof updateMilestoneSchema>;

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

  Registers the update_milestone tool in the central ToolRegistry during initialization

  this.registerTool(updateMilestoneTool);

• src/index.ts:268-269 (handler)

  MCP tool dispatch handler: routes call_tool requests for 'update_milestone' to ProjectManagementService

  case "update_milestone":
    return await this.service.updateMilestone(args);