feat: increase result per page for prs issues listings (#102)

Author: saidsef

.gitignore

@@ -1 +1 @@
-.python-version .venv/ __pycache__/
+.python-version .venv/ __pycache__/ build/ mcp_github_pr_issue_analyser.egg-info/

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-github-pr-issue-analyser"
-version = "2.6.2"
+version = "2.7.0"
 description = "MCP GitHub Issues Create/Update and PR Analyse"
 readme = "README.md"
 requires-python = ">=3.12"

src/mcp_github/github_integration.py

@@ -21,7 +21,8 @@
 import requests
 import traceback
 from os import getenv
-from typing import Dict, Any, Optional, Literal
+from pydantic import BaseModel, conint
+from typing import Annotated, Any, Dict, Optional, Literal
 
 GITHUB_TOKEN = getenv('GITHUB_TOKEN')
 
@@ -30,6 +31,8 @@
 logging.basicConfig(level=logging.WARNING)
 
 class GitHubIntegration:
+    PerPage = conint(ge=1, le=100)
+
     def __init__(self):
         """
         Initialise the GitHubIntegration class.
@@ -267,13 +270,22 @@ def update_pr_description(self, repo_owner: str, repo_name: str, pr_number: int,
             traceback.print_exc()
             return None
 
-    def list_open_issues_prs(self, repo_owner: str, issue: Literal['pr', 'issue'] = 'pr', filtering: Literal['user', 'owner', 'involves'] = 'involves') -> Dict[str, Any]:
+    def list_open_issues_prs(
+            self,
+            repo_owner: str,
+            issue: Literal['pr', 'issue'] = 'pr',
+            filtering: Literal['user', 'owner', 'involves'] = 'involves',
+            per_page: Annotated[PerPage, "Number of results per page (1-100)"] = 50,
+            page: int = 1
+    ) -> Dict[str, Any]:
         """
         Lists all open Issues or Pull Requests for a given repository owner.
         Args:
             repo_owner (str): The owner of the repository.
             issue (Literal['pr', 'issue']): The type of items to list, either 'pr' for pull requests or 'issue' for issues. Defaults to 'pr'.
             filtering (Literal['user', 'owner', 'involves']): The filtering criteria for the search. Defaults to 'involves'.
+            per_page (Annotated[int, PerPage]): The number of results to return per page, range 1-100. Defaults to 50.
+            page (int): The page number to retrieve. Defaults to 1.
         Returns:
             Dict[str, Any]: A dictionary containing the list of open pull requests or issues, depending on the value of the `issue` parameter.
             None: If an error occurs during the request.
@@ -283,7 +295,7 @@ def list_open_issues_prs(self, repo_owner: str, issue: Literal['pr', 'issue'] =
         logging.info(f"Listing open {issue}s for {repo_owner}")
 
         # Construct the search URL
-        search_url = f"https://api.github.com/search/issues?q=is:{issue}+is:open+{filtering}:{repo_owner}"
+        search_url = f"https://api.github.com/search/issues?q=is:{issue}+is:open+{filtering}:{repo_owner}&per_page={per_page}&page={page}"
 
         try:
             response = requests.get(search_url, headers=self._get_headers())

src/mcp_github/issues_pr_analyser.py

@@ -21,7 +21,7 @@
 import logging
 import traceback
 from os import getenv
-from typing import Any, Dict, List, Literal
+from typing import Annotated, Any, Dict, List, Literal
 from mcp.server.fastmcp import FastMCP
 from .github_integration import GitHubIntegration as GI
 from .ip_integration import IPIntegration as IP
@@ -210,7 +210,13 @@ async def add_github_pr_comment(repo_owner: str, repo_name: str, pr_number: int,
                 return {"status": "error", "message": error_msg}
 
         @self.mcp.tool()
-        async def list_github_issues_prs(repo_owner: str, issue: Literal['pr', 'issue'] = 'pr', filtering: Literal['user', 'owner', 'involves'] = 'involves') -> dict[str, Any]:
+        async def list_github_issues_prs(
+            repo_owner: str,
+            issue: Literal['pr', 'issue'] = 'pr',
+            filtering: Literal['user', 'owner', 'involves'] = 'involves',
+            per_page: Annotated[GI.PerPage, "Number of results per page (1-100)"] = 50,
+            page: int = 1
+        ) -> dict[str, Any]:  # type: ignore
             """
             Lists open issues or pull requests for a specified GitHub repository.
             - Present the issues or pull requests in a markdown table format.
@@ -219,13 +225,15 @@ async def list_github_issues_prs(repo_owner: str, issue: Literal['pr', 'issue']
                 repo_owner (str): The owner of the GitHub repository.
                 issue (Literal['pr', 'issue']): The type of item to list, either 'pr' for pull requests or 'issue' for issues. Defaults to 'pr'.
                 filtering (Literal['user', 'owner', 'involves']): The filtering criteria for the search. Defaults to 'involves'.
+                per_page (Annotated[PerPage, "Number of results per page (1-100)"]): The number of results to return per page, range 1-100. Defaults to 50.
+                page (int): The page number to retrieve. Defaults to 1.
             Returns:
-                dict[str, Any]: A dictionary containing the list of open issues or pull requests.
-                    Returns an error message if an exception occurs during the listing process.
+            dict[str, Any]: A dictionary containing the list of open issues or pull requests.
+                Returns an error message if an exception occurs during the listing process.
             """
             logging.info({"status": "info", "message": f"Listing open {issue} for {repo_owner}"})
             try:
-                open_issues_prs = self.gi.list_open_issues_prs(repo_owner, issue, filtering)
+                open_issues_prs = self.gi.list_open_issues_prs(repo_owner, issue, filtering, per_page=per_page, page=page)
                 return open_issues_prs
             except Exception as e:
                 error_msg = f"Error listing {issue} for {repo_owner}: {str(e)}"