mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:3164-3200 (handler)

  Main handler function that fetches all project items and filters those assigned to the specified iteration ID by checking field values.

  async getIterationItems(data: {
    projectId: string;
    iterationId: string;
    limit?: number;
  }): Promise<{
    items: Array<{
      id: string;
      title: string;
      type: string;
      status?: string;
    }>;
  }> {
    try {
      const items = await this.listProjectItems({
        projectId: data.projectId,
        limit: data.limit || 50
      });
  
      // Filter items that have the iteration field set to this iteration
      const iterationItems = items.filter((item: any) => {
        // Check if any field value matches the iteration ID
        const fieldValues = item.fieldValues || [];
        return fieldValues.some((fv: any) => fv.value === data.iterationId);
      });
  
      return {
        items: iterationItems.map((item: any) => ({
          id: item.id,
          title: item.title || 'Untitled',
          type: item.type,
          status: item.status
        }))
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:2311-2325 (schema)

  ToolDefinition including name, description, input schema (getIterationItemsSchema), and examples for the get_iteration_items tool.

  export const getIterationItemsTool: ToolDefinition<GetIterationItemsArgs> = {
    name: "get_iteration_items",
    description: "Get all items assigned to a specific iteration",
    schema: getIterationItemsSchema as unknown as ToolSchema<GetIterationItemsArgs>,
    examples: [
      {
        name: "Get iteration items",
        description: "Get all issues/PRs in an iteration",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          iterationId: "PVTIF_lADOLhQ7gc4AOEbH"
        }
      }
    ]
  };

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

  Registers the getIterationItemsTool in the central ToolRegistry singleton.

  this.registerTool(getIterationItemsTool);

• src/index.ts:494-495 (registration)

  MCP server dispatches call_tool requests for get_iteration_items to the ProjectManagementService handler.

  case "get_iteration_items":
    return await this.service.getIterationItems(args);

• src/infrastructure/tools/ToolSchemas.ts:1358-1364 (schema)

  Zod input schema validation for get_iteration_items tool parameters.

  export const getIterationItemsSchema = z.object({
    projectId: z.string().min(1, "Project ID is required"),
    iterationId: z.string().min(1, "Iteration ID is required"),
    limit: z.number().int().positive().default(50).optional()
  });
  
  export type GetIterationItemsArgs = z.infer<typeof getIterationItemsSchema>;