feat: Add filtering option to list_open_issues_prs and improve type hints (#83)

* feat(github): add filtering option to list_open_issues_prs method

Add filtering parameter to list_open_issues_prs to support 'user', 'owner', or 'involves' filters.
Update corresponding tool in PRIssueAnalyser to accept and pass the filtering argument.
Bump version to 2.6.0.

* chore: func signature issue set to literal

Function signature  - suggest keeping Literal type for better hints

Author: saidsef

pyproject.toml

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

src/mcp_github/github_integration.py

@@ -267,12 +267,13 @@ 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') -> Dict[str, Any]:
+    def list_open_issues_prs(self, repo_owner: str, issue: Literal['pr', 'issue'] = 'pr', filtering: Literal['user', 'owner', 'involves'] = 'involves') -> 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'.
         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.
@@ -282,7 +283,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+user:{repo_owner}"
+        search_url = f"https://api.github.com/search/issues?q=is:{issue}+is:open+{filtering}:{repo_owner}"
 
         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
+from typing import 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,21 +210,22 @@ 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: str) -> dict[str, Any]:
+        async def list_github_issues_prs(repo_owner: str, issue: Literal['pr', 'issue'] = 'pr', filtering: Literal['user', 'owner', 'involves'] = 'involves') -> dict[str, Any]:
             """
             Lists open issues or pull requests for a specified GitHub repository.
             - Present the issues or pull requests in a markdown table format.
             - Add index column to the table, and make the title link to the issue or pull request.
             Args:
                 repo_owner (str): The owner of the GitHub repository.
-                issue (str): The type of items to list, either 'pr' for pull requests or 'issue' for issues. Defaults to 'pr'.
+                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'.
             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.
             """
             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)
+                open_issues_prs = self.gi.list_open_issues_prs(repo_owner, issue, filtering)
                 return open_issues_prs
             except Exception as e:
                 error_msg = f"Error listing {issue} for {repo_owner}: {str(e)}"