mcp-github-project-manager

Instructions

Implementation Reference

• src/infrastructure/github/repositories/GitHubProjectRepository.ts:334-378 (handler)

  Core handler: Executes GraphQL mutation `createProjectV2View` to create a new GitHub Projects v2 view with specified name and layout.
  async createView(projectId: ProjectId, name: string, layout: ProjectView["layout"]): Promise<ProjectView> { const mutation = ` mutation($input: CreateProjectV2ViewInput!) { createProjectV2View(input: $input) { projectV2View { id name layout } } } `; try { const graphqlLayout = mapToGraphQLViewLayout(layout); const variables = { input: { projectId, name, layout: graphqlLayout } }; const response = await this.graphql<CreateProjectV2ViewResponse>(mutation, variables); if (!response.createProjectV2View?.projectV2View) { throw new Error('Failed to create project view: Invalid response from GitHub API'); } const view = response.createProjectV2View.projectV2View; return { id: view.id, name: view.name, layout: view.layout.toLowerCase() as ViewLayout, fields: [], sortBy: [], groupBy: undefined, filters: [] }; } catch (error) { this.logger.error(`Failed to create project view for project ${projectId}`, error); throw this.handleGraphQLError(error); }
• src/services/ProjectManagementService.ts:2389-2403 (handler)

  Service layer handler: Validates input and delegates to GitHubProjectRepository.createView
  async createProjectView(data: { projectId: string; name: string; layout: 'board' | 'table' | 'timeline' | 'roadmap'; }): Promise<ProjectView> { try { return await this.projectRepo.createView( data.projectId, data.name, data.layout ); } catch (error) { throw this.mapErrorToMCPError(error); } }
• src/index.ts:393-394 (handler)

  MCP tool dispatcher: Routes 'create_project_view' tool calls to ProjectManagementService.createProjectView
  case "create_project_view": return await this.service.createProjectView(args);
• src/infrastructure/tools/ToolSchemas.ts:849-864 (schema)

  Tool definition including Zod input schema (projectId, name, layout), description, and examples
  export const createProjectViewTool: ToolDefinition<CreateProjectViewArgs> = { name: "create_project_view", description: "Create a new view for a GitHub project", schema: createProjectViewSchema as unknown as ToolSchema<CreateProjectViewArgs>, examples: [ { name: "Create kanban board view", description: "Create a board view for a project", args: { projectId: "PVT_kwDOLhQ7gc4AOEbH", name: "Development Board", layout: "board" } } ] };
• src/infrastructure/tools/ToolRegistry.ts:247-247 (registration)

  Registers createProjectViewTool in the central ToolRegistry singleton (imported from ToolSchemas.ts line 44)
  this.registerTool(createProjectViewTool);