MCP GitHub Project Manager

Instructions

Implementation Reference

• src/infrastructure/github/repositories/GitHubMilestoneRepository.ts:132-140 (handler)

  Core implementation of milestone deletion using GitHub REST API (octokit.rest.issues.deleteMilestone). This is the actual execution logic for deleting the milestone.

  async delete(id: MilestoneId): Promise<void> {
    // Use REST API for milestone deletion since GraphQL doesn't support it
    await this.rest(
      (params) => this.octokit.rest.issues.deleteMilestone(params),
      {
        milestone_number: parseInt(id)
      }
    );
  }

• src/services/ProjectManagementService.ts:1895-1908 (handler)

  Service layer handler for delete_milestone tool. Calls the repository to delete the milestone and returns formatted success response.

  async deleteMilestone(data: {
    milestoneId: string;
  }): Promise<{ success: boolean; message: string }> {
    try {
      await this.milestoneRepo.delete(data.milestoneId);
  
      return {
        success: true,
        message: `Milestone ${data.milestoneId} has been deleted`
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/index.ts:271-272 (handler)

  MCP tool dispatch handler in executeToolHandler switch statement. Dispatches delete_milestone tool call to the ProjectManagementService.

  case "delete_milestone":
    return await this.service.deleteMilestone(args);

• src/infrastructure/tools/ToolSchemas.ts:759-779 (schema)

  Zod schema definition for delete_milestone tool input validation (milestoneId: string).

  // Schema for delete_milestone tool
  export const deleteMilestoneSchema = z.object({
    milestoneId: z.string().min(1, "Milestone ID is required"),
  });
  
  export type DeleteMilestoneArgs = z.infer<typeof deleteMilestoneSchema>;
  
  // 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>;
  
  // Schema for add_issues_to_sprint tool
  export const addIssuesToSprintSchema = z.object({

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

  Registration of deleteMilestoneTool in the central ToolRegistry during initialization.

  this.registerTool(deleteMilestoneTool);

• src/infrastructure/tools/ToolSchemas.ts:1166-1179 (schema)

  ToolDefinition for delete_milestone including name, description, schema reference, and usage examples.

  export const deleteMilestoneTool: ToolDefinition<DeleteMilestoneArgs> = {
    name: "delete_milestone",
    description: "Delete a GitHub milestone",
    schema: deleteMilestoneSchema as unknown as ToolSchema<DeleteMilestoneArgs>,
    examples: [
      {
        name: "Delete milestone",
        description: "Delete a milestone by ID",
        args: {
          milestoneId: "42"
        }
      }
    ]
  };