mcp-github-project-manager

Instructions

Implementation Reference

• src/index.ts:306-307 (handler)

  MCP tool dispatch handler in index.ts that calls the service method for get_issue tool execution.

  case "get_issue":
    return await this.service.getIssue(args.issueId);

• src/infrastructure/tools/ToolSchemas.ts:490-503 (schema)

  Tool definition including schema, description, and examples for get_issue.

  export const getIssueTool: ToolDefinition<GetIssueArgs> = {
    name: "get_issue",
    description: "Get details of a specific GitHub issue",
    schema: getIssueSchema as unknown as ToolSchema<GetIssueArgs>,
    examples: [
      {
        name: "Get issue details",
        description: "Get detailed information about an issue",
        args: {
          issueId: "42"
        }
      }
    ]
  };

• src/infrastructure/tools/ToolSchemas.ts:159-163 (schema)

  Zod input schema validation for get_issue tool parameters.

  export const getIssueSchema = z.object({
    issueId: z.string().min(1, "Issue ID is required"),
  });
  
  export type GetIssueArgs = z.infer<typeof getIssueSchema>;

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

  Registration of getIssueTool in the central ToolRegistry singleton.

  this.registerTool(getIssueTool);

• src/services/ProjectManagementService.ts:797-803 (helper)

  Service layer method that delegates to GitHubIssueRepository.findById for retrieving issue details.

  async getIssue(issueId: string): Promise<Issue | null> {
    try {
      return await this.issueRepo.findById(issueId);
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }