mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:1378-1434 (handler)

  Implements the core logic for creating a draft issue in a GitHub project using GraphQL mutation addProjectV2DraftIssue. Handles input validation, API call, and error mapping.

  async createDraftIssue(data: {
    projectId: string;
    title: string;
    body?: string;
    assigneeIds?: string[];
  }): Promise<{ id: string; title: string; body: string }> {
    try {
      const mutation = `
        mutation($input: AddProjectV2DraftIssueInput!) {
          addProjectV2DraftIssue(input: $input) {
            projectV2Item {
              id
              content {
                ... on DraftIssue {
                  id
                  title
                  body
                }
              }
            }
          }
        }
      `;
  
      interface AddDraftIssueResponse {
        addProjectV2DraftIssue: {
          projectV2Item: {
            id: string;
            content: {
              id: string;
              title: string;
              body: string;
            };
          };
        };
      }
  
      const response = await this.factory.graphql<AddDraftIssueResponse>(mutation, {
        input: {
          projectId: data.projectId,
          title: data.title,
          body: data.body || '',
          assigneeIds: data.assigneeIds || []
        }
      });
  
      const content = response.addProjectV2DraftIssue.projectV2Item.content;
  
      return {
        id: content.id,
        title: content.title,
        body: content.body
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:594-609 (schema)

  Defines the ToolDefinition for create_draft_issue including Zod input schema, description, and usage examples.

  export const createDraftIssueTool: ToolDefinition<CreateDraftIssueArgs> = {
    name: "create_draft_issue",
    description: "Create a draft issue in a GitHub project. Draft issues are native to Projects v2 and don't require creating a repository issue first.",
    schema: createDraftIssueSchema as unknown as ToolSchema<CreateDraftIssueArgs>,
    examples: [
      {
        name: "Create draft task",
        description: "Create a draft issue for brainstorming without committing to the repository",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH",
          title: "Explore new authentication options",
          body: "Research OAuth providers and compare features"
        }
      }
    ]
  };

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

  Registers the createDraftIssueTool (and related draft tools) in the central ToolRegistry singleton.

  // Register draft issue tools
  this.registerTool(createDraftIssueTool);
  this.registerTool(updateDraftIssueTool);
  this.registerTool(deleteDraftIssueTool);

• src/index.ts:333-334 (registration)

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

  case "create_draft_issue":
    return await this.service.createDraftIssue(args);