mcp-github-project-manager

Instructions

Implementation Reference

• src/infrastructure/github/repositories/GitHubAutomationRuleRepository.ts:28-69 (handler)

  Core handler implementing the GitHub GraphQL mutation to create ProjectV2 automation rules

  async create(data: CreateAutomationRule): Promise<AutomationRule> {
    const mutation = `
      mutation($input: CreateProjectV2RuleInput!) {
        createProjectV2Rule(input: $input) {
          projectRule {
            id
            databaseId
            createdAt
            updatedAt
            isActive
            name
            ruleTrigger {
              type
              whenStateEquals
              whenStateWas
              whenFieldValueEquals
              whenFieldId
            }
            ruleActions {
              type
              fieldId
              value
              projectItemId
              sourceFieldId
              targetFieldId
              labelName
              milestoneId
            }
          }
        }
      }
    `;
  
    try {
      const variables = this.prepareCreateRuleVariables(data);
      const response = await this.graphql<CreateProjectRuleResponse>(mutation, variables);
      return this.mapGitHubRuleToAutomationRule(response.createProjectV2Rule.projectRule, data.projectId);
    } catch (error) {
      this.logger.error(`Failed to create automation rule for project ${data.projectId}`, error);
      throw this.handleGraphQLError(error);
    }
  }

• src/services/ProjectManagementService.ts:2804-2858 (handler)

  Service layer handler that validates input, checks project existence, and delegates to repository

  async createAutomationRule(data: {
    name: string;
    description?: string;
    projectId: string;
    enabled?: boolean;
    triggers: Array<{
      type: string;
      resourceType?: string;
      conditions?: Array<{
        field: string;
        operator: string;
        value: any;
      }>;
    }>;
    actions: Array<{
      type: string;
      parameters: Record<string, any>;
    }>;
  }): Promise<{
    id: string;
    name: string;
    description?: string;
    projectId: string;
    enabled: boolean;
    triggers: any[];
    actions: any[];
  }> {
    try {
      // Verify project exists
      const project = await this.projectRepo.findById(data.projectId);
      if (!project) {
        throw new ResourceNotFoundError(ResourceType.PROJECT, data.projectId);
      }
  
      const rule = await this.automationRepo.create({
        name: data.name,
        description: data.description,
        projectId: data.projectId,
        enabled: data.enabled ?? true,
        triggers: data.triggers as any,
        actions: data.actions as any
      });
  
      return {
        id: rule.id,
        name: rule.name,
        description: rule.description,
        projectId: rule.projectId,
        enabled: rule.enabled,
        triggers: rule.triggers,
        actions: rule.actions
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }

• src/infrastructure/tools/ToolSchemas.ts:2133-2176 (schema)

  MCP tool definition including name, description, input schema, and examples

  export const createAutomationRuleTool: ToolDefinition<CreateAutomationRuleArgs> = {
    name: "create_automation_rule",
    description: "Create a new automation rule for a GitHub project",
    schema: createAutomationRuleSchema as unknown as ToolSchema<CreateAutomationRuleArgs>,
    examples: [
      {
        name: "Auto-label PRs",
        description: "Automatically add 'needs-review' label when PR is opened",
        args: {
          name: "Auto-label new PRs",
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          enabled: true,
          triggers: [{
            type: "pr_opened"
          }],
          actions: [{
            type: "add_label",
            parameters: { labelName: "needs-review" }
          }]
        }
      },
      {
        name: "Auto-assign issues",
        description: "Automatically assign issues with 'bug' label to maintainer",
        args: {
          name: "Auto-assign bugs",
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          enabled: true,
          triggers: [{
            type: "issue_labeled",
            conditions: [{
              field: "label",
              operator: "equals",
              value: "bug"
            }]
          }],
          actions: [{
            type: "assign_user",
            parameters: { username: "maintainer" }
          }]
        }
      }
    ]
  };

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

  Registers the create_automation_rule tool in the central ToolRegistry singleton

  this.registerTool(createAutomationRuleTool);
  this.registerTool(updateAutomationRuleTool);
  this.registerTool(deleteAutomationRuleTool);
  this.registerTool(getAutomationRuleTool);
  this.registerTool(listAutomationRulesTool);
  this.registerTool(enableAutomationRuleTool);
  this.registerTool(disableAutomationRuleTool);

• src/domain/automation-types.ts:68-75 (schema)

  Domain type definition for CreateAutomationRule input structure used across services and repository

  export interface CreateAutomationRule {
    name: string;
    description?: string;
    projectId: string;
    enabled?: boolean;
    triggers: Omit<AutomationTrigger, "id">[];
    actions: Omit<AutomationAction, "id">[];
  }