MCP GitHub Project Manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:954-966 (handler)

  Core handler method in ProjectManagementService that executes the delete_project tool logic. Validates input implicitly via schema, calls repository delete, and formats success response.

  async deleteProject(data: {
    projectId: string;
  }): Promise<{ success: boolean; message: string }> {
    try {
      await this.projectRepo.delete(data.projectId);
      return {
        success: true,
        message: `Project ${data.projectId} has been deleted`,
      };
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/github/repositories/GitHubProjectRepository.ts:171-187 (handler)

  Repository implementation that performs the actual GitHub GraphQL deleteProjectV2 mutation to delete the project.

  async delete(id: ProjectId): Promise<void> {
    const mutation = `
      mutation($input: DeleteProjectV2Input!) {
        deleteProjectV2(input: $input) {
          projectV2 {
            id
          }
        }
      }
    `;
  
    await this.graphql(mutation, {
      input: {
        projectId: id,
      },
    });
  }

• src/infrastructure/tools/ToolSchemas.ts:836-849 (schema)

  Tool definition including schema, description, and examples for delete_project tool.

  export const deleteProjectTool: ToolDefinition<DeleteProjectArgs> = {
    name: "delete_project",
    description: "Delete a GitHub project",
    schema: deleteProjectSchema as unknown as ToolSchema<DeleteProjectArgs>,
    examples: [
      {
        name: "Delete project",
        description: "Delete a GitHub project by ID",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH"
        }
      }
    ]
  };

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

  Registration of the deleteProjectTool in the ToolRegistry during initialization.

  this.registerTool(updateProjectTool);
  this.registerTool(deleteProjectTool);

• src/index.ts:252-253 (handler)

  Top-level tool dispatcher in MCP server that routes delete_project calls to the service handler.

  case "delete_project":
    return await this.service.deleteProject(args);