mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:3205-3240 (handler)

  The main handler function that implements the get_iteration_by_date tool logic. It retrieves the iteration configuration for the project and finds which iteration contains the specified date by comparing date ranges.

  async getIterationByDate(data: {
    projectId: string;
    date: string;
    fieldName?: string;
  }): Promise<{
    id: string;
    title: string;
    startDate: string;
    endDate: string;
    duration: number;
  } | null> {
    try {
      const config = await this.getIterationConfiguration(data);
      const targetDate = new Date(data.date);
  
      for (const iteration of config.iterations) {
        const start = new Date(iteration.startDate);
        const end = new Date(start);
        end.setDate(end.getDate() + iteration.duration);
  
        if (targetDate >= start && targetDate < end) {
          return {
            id: iteration.id,
            title: iteration.title,
            startDate: iteration.startDate,
            endDate: end.toISOString(),
            duration: iteration.duration
          };
        }
      }
  
      return null;
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:2327-2341 (schema)

  ToolDefinition object including the Zod input schema, description, and examples for the get_iteration_by_date tool.

  export const getIterationByDateTool: ToolDefinition<GetIterationByDateArgs> = {
    name: "get_iteration_by_date",
    description: "Find which iteration contains a specific date",
    schema: getIterationByDateSchema as unknown as ToolSchema<GetIterationByDateArgs>,
    examples: [
      {
        name: "Find iteration",
        description: "Find which iteration contains a specific date",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          date: "2025-01-15T00:00:00Z"
        }
      }
    ]
  };

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

  Registers the getIterationByDateTool in the central ToolRegistry singleton.

  this.registerTool(getIterationConfigurationTool);
  this.registerTool(getCurrentIterationTool);
  this.registerTool(getIterationItemsTool);
  this.registerTool(getIterationByDateTool);
  this.registerTool(assignItemsToIterationTool);

• src/index.ts:497-499 (handler)

  Dispatches tool calls to the ProjectManagementService handler in the main MCP server switch statement.

  case "get_iteration_by_date":
    return await this.service.getIterationByDate(args);