MCP GitHub Project Manager

Instructions

Input Schema

Input Schema (JSON Schema)

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" } } ] };