mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:612-618 (handler)

  Core handler implementation that fetches project details by ID using the GitHubProjectRepository

  async getProject(projectId: string): Promise<Project | null> {
    try {
      return await this.projectRepo.findById(projectId);
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/index.ts:265-267 (handler)

  MCP server dispatch handler that routes 'get_project' tool calls to the ProjectManagementService

  case "get_project":
    return await this.service.getProject(args.projectId);

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

  Registers the getProjectTool in the central ToolRegistry singleton

  this.registerTool(getProjectTool);

• src/infrastructure/tools/ToolSchemas.ts:400-413 (schema)

  Defines the get_project tool including input schema (projectId: string), description, and usage examples

  export const getProjectTool: ToolDefinition<GetProjectArgs> = {
    name: "get_project",
    description: "Get details of a specific GitHub project",
    schema: getProjectSchema as unknown as ToolSchema<GetProjectArgs>,
    examples: [
      {
        name: "Get project details",
        description: "Get details for a specific project",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH"
        }
      }
    ]
  };

• src/infrastructure/tools/ToolSchemas.ts:108-112 (schema)

  Zod input schema validation for get_project tool parameters

  export const getProjectSchema = z.object({
    projectId: z.string().min(1, "Project ID is required"),
  });
  
  export type GetProjectArgs = z.infer<typeof getProjectSchema>;