mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:945-967 (handler)

  Main handler function for create_sprint tool. Validates input parameters, constructs Sprint data object with PLANNED status, and delegates creation to GitHubSprintRepository.

  async createSprint(data: {
    title: string;
    description: string;
    startDate: string;
    endDate: string;
    issueIds?: string[];
  }): Promise<Sprint> {
    try {
      // Create data object that matches the expected type
      const sprintData: Omit<Sprint, "id" | "createdAt" | "updatedAt"> = {
        title: data.title,
        description: data.description,
        startDate: data.startDate,
        endDate: data.endDate,
        status: ResourceStatus.PLANNED,
        issues: data.issueIds?.map(id => id.toString()) || []
      };
  
      return await this.sprintRepo.create(sprintData);
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:304-312 (schema)

  Zod schema defining input validation for create_sprint tool parameters: title, description, startDate, endDate, and optional issueIds.

  export const createSprintSchema = z.object({
    title: z.string().min(1, "Sprint title is required"),
    description: z.string().min(1, "Sprint description is required"),
    startDate: z.string().datetime("Start date must be a valid ISO date string"),
    endDate: z.string().datetime("End date must be a valid ISO date string"),
    issueIds: z.array(z.string()).default([]),
  });
  
  export type CreateSprintArgs = z.infer<typeof createSprintSchema>;

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

  Registration of createSprintTool in the central ToolRegistry singleton instance.

  this.registerTool(createSprintTool);

• src/infrastructure/tools/ToolSchemas.ts:774-791 (registration)

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

  export const createSprintTool: ToolDefinition<CreateSprintArgs> = {
    name: "create_sprint",
    description: "Create a new development sprint",
    schema: createSprintSchema as unknown as ToolSchema<CreateSprintArgs>,
    examples: [
      {
        name: "Create two-week sprint",
        description: "Create a two-week sprint with initial issues",
        args: {
          title: "Sprint 1: User Authentication",
          description: "First sprint focused on user authentication features",
          startDate: "2025-06-01T00:00:00Z",
          endDate: "2025-06-15T00:00:00Z",
          issueIds: ["101", "102", "103"]
        }
      }
    ]
  };

• src/index.ts:365-366 (handler)

  MCP server dispatcher routes 'create_sprint' tool calls to ProjectManagementService.createSprint method.

  case "create_sprint":
    return await this.service.createSprint(args);