GitHub PR Issue Analyser

Instructions

Implementation Reference

• src/mcp_github/github_integration.py:110-150 (handler)

  The handler function that executes the get_pr_content tool logic. Fetches PR details (title, body, author, created_at, updated_at, state) from GitHub API endpoint /repos/{owner}/{repo}/pulls/{pr_number}, extracts key fields, handles errors by returning error dict.
  def get_pr_content(self, repo_owner: str, repo_name: str, pr_number: int) -> Dict[str, Any]: """ Fetches the content/details of a specific pull request from a GitHub repository. Args: repo_owner (str): The owner of the repository. repo_name (str): The name of the repository. pr_number (int): The pull request number. Returns: Dict[str, Any]: A dictionary containing the pull request's title, description, author, creation and update timestamps, and state. Returns None if an error occurs during the fetch operation. Error Handling: Logs an error message and prints the traceback if the request fails or an exception is raised during processing. """ logging.info(f"Fetching PR content for {repo_owner}/{repo_name}#{pr_number}") # Construct the PR URL pr_url = self._get_pr_url(repo_owner, repo_name, pr_number) try: # Fetch PR details response = requests.get(pr_url, headers=self._get_headers(), timeout=TIMEOUT) response.raise_for_status() pr_data = response.json() # Extract relevant information pr_info = { 'title': pr_data['title'], 'description': pr_data['body'], 'author': pr_data['user']['login'], 'created_at': pr_data['created_at'], 'updated_at': pr_data['updated_at'], 'state': pr_data['state'] } logging.info("Successfully fetched PR content") return pr_info except Exception as e: logging.error(f"Error fetching PR content: {str(e)}") traceback.print_exc() return {"status": "error", "message": str(e)}
• src/mcp_github/issues_pr_analyser.py:106-113 (registration)

  Registers all public methods of GitHubIntegration instance (self.gi) as MCP tools using FastMCP.add_tool in a loop over inspect.getmembers. This automatically registers get_pr_content since it does not start with underscore.
  self.register_tools(self.gi) self.register_tools(self.ip) def register_tools(self, methods: Any = None) -> None: for name, method in inspect.getmembers(methods): if (inspect.isfunction(method) or inspect.ismethod(method)) and not name.startswith("_"): self.mcp.add_tool(method)
• src/mcp_github/github_integration.py:67-80 (helper)

  Helper method used by get_pr_content to construct the GitHub API URL: https://api.github.com/repos/{repo_owner}/{repo_name}/pulls/{pr_number}
  def _get_pr_url(self, repo_owner: str, repo_name: str, pr_number: int) -> str: """ Construct the GitHub API URL for a specific pull request. Args: repo_owner (str): The owner of the GitHub repository. repo_name (str): The name of the GitHub repository. pr_number (int): The pull request number. Returns: str: The formatted GitHub API URL for the specified pull request. Raises: ValueError: If any of the arguments are empty or if pr_number is not a positive integer. """ url = f"https://api.github.com/repos/{repo_owner}/{repo_name}/pulls/{pr_number}" return url
• src/mcp_github/github_integration.py:51-65 (helper)

  Helper method used by get_pr_content to generate HTTP headers with GitHub token authorization and v3 API accept header.
  def _get_headers(self): """ Constructs the HTTP headers required for GitHub API requests, including the authorization token. Returns: dict: A dictionary containing the required HTTP headers. Error Handling: Raises ValueError if the GitHub token is not set. """ if not self.github_token: raise ValueError("GitHub token is missing for API requests") headers = { 'Authorization': f'token {self.github_token}', 'Accept': 'application/vnd.github.v3+json' } return headers
• src/mcp_github/issues_pr_analyser.py:67-67 (registration)

  Instantiates the GitHubIntegration instance (self.gi = GI()) whose methods, including get_pr_content, will be registered as MCP tools.
  self.gi = GI()