github-issue-pr-manager 0.1.0__py3-none-any.whl

github_issue_pr_manager/__init__.py

@@ -0,0 +1,5 @@
+"""GitHub Issue PR Manager - MCP server for managing GitHub issues and pull requests, providing AI agents with tools to gather context and close issues through PR workflows"""
+
+from .server import main, mcp
+
+__all__ = ["main", "mcp"]

github_issue_pr_manager/server.py

@@ -0,0 +1,299 @@
+"""
+GitHub Issue PR Manager
+
+MCP server for managing GitHub issues and pull requests, providing AI agents with tools to gather context and close issues through PR workflows
+"""
+
+from fastmcp import FastMCP
+
+# Initialize the MCP server
+mcp = FastMCP("GitHub Issue PR Manager")
+
+@mcp.tool()
+def get_issue(owner: str, repo: str, issue_number: int) -> str:
+    """Get detailed information about a GitHub issue including comments and linked PRs
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        issue_number: Issue number
+
+    Returns:
+        Issue details including title, body, state, labels, assignees, and comments
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    url = f'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}'
+    response = requests.get(url, headers=headers)
+    if response.status_code == 200:
+        issue = response.json()
+        # Get comments
+        comments_url = issue['comments_url']
+        comments_response = requests.get(comments_url, headers=headers)
+        comments = comments_response.json() if comments_response.status_code == 200 else []
+        issue['all_comments'] = comments
+        return issue
+    else:
+        return {'error': f'Failed to get issue: {response.status_code}'}
+
+@mcp.tool()
+def list_issue_prs(owner: str, repo: str, issue_number: int) -> str:
+    """List all pull requests that reference or are linked to a specific issue
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        issue_number: Issue number to find related PRs for
+
+    Returns:
+        List of pull requests that reference the issue
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    # Search for PRs mentioning the issue
+    query = f'repo:{owner}/{repo} type:pr #{issue_number}'
+    search_url = f'https://api.github.com/search/issues?q={query}'
+    response = requests.get(search_url, headers=headers)
+    if response.status_code == 200:
+        return response.json()['items']
+    else:
+        return {'error': f'Failed to search PRs: {response.status_code}'}
+
+@mcp.tool()
+def get_pull_request(owner: str, repo: str, pr_number: int) -> str:
+    """Get detailed information about a pull request including its status and mergability
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        pr_number: Pull request number
+
+    Returns:
+        PR details including state, mergeable status, checks, and review status
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    url = f'https://api.github.com/repos/{owner}/{repo}/pulls/{pr_number}'
+    response = requests.get(url, headers=headers)
+    if response.status_code == 200:
+        pr = response.json()
+        # Get review status
+        reviews_url = f'https://api.github.com/repos/{owner}/{repo}/pulls/{pr_number}/reviews'
+        reviews_response = requests.get(reviews_url, headers=headers)
+        pr['reviews'] = reviews_response.json() if reviews_response.status_code == 200 else []
+        return pr
+    else:
+        return {'error': f'Failed to get PR: {response.status_code}'}
+
+@mcp.tool()
+def list_repository_prs(owner: str, repo: str, state: str) -> str:
+    """List pull requests in a repository with optional filtering by state
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        state: PR state filter (open, closed, all)
+
+    Returns:
+        List of pull requests in the repository
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    params = {}
+    if state:
+        params['state'] = state
+    url = f'https://api.github.com/repos/{owner}/{repo}/pulls'
+    response = requests.get(url, headers=headers, params=params)
+    if response.status_code == 200:
+        return response.json()
+    else:
+        return {'error': f'Failed to list PRs: {response.status_code}'}
+
+@mcp.tool()
+def create_pull_request(owner: str, repo: str, title: str, body: str, head: str, base: str) -> str:
+    """Create a new pull request
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        title: Pull request title
+        body: Pull request description
+        head: Branch name containing the changes
+        base: Branch name to merge into (default: main)
+
+    Returns:
+        Created pull request details
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    data = {
+        'title': title,
+        'body': body,
+        'head': head,
+        'base': base or 'main'
+    }
+    url = f'https://api.github.com/repos/{owner}/{repo}/pulls'
+    response = requests.post(url, headers=headers, json=data)
+    if response.status_code == 201:
+        return response.json()
+    else:
+        return {'error': f'Failed to create PR: {response.status_code} - {response.text}'}
+
+@mcp.tool()
+def merge_pull_request(owner: str, repo: str, pr_number: int, commit_title: str, merge_method: str) -> str:
+    """Merge a pull request if it's ready
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        pr_number: Pull request number
+        commit_title: Merge commit title (optional)
+        merge_method: Merge method (merge, squash, rebase)
+
+    Returns:
+        Merge result information
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    data = {}
+    if commit_title:
+        data['commit_title'] = commit_title
+    if merge_method:
+        data['merge_method'] = merge_method
+    url = f'https://api.github.com/repos/{owner}/{repo}/pulls/{pr_number}/merge'
+    response = requests.put(url, headers=headers, json=data)
+    if response.status_code == 200:
+        return response.json()
+    else:
+        return {'error': f'Failed to merge PR: {response.status_code} - {response.text}'}
+
+@mcp.tool()
+def close_issue(owner: str, repo: str, issue_number: int, comment: str) -> str:
+    """Close an issue and optionally add a closing comment
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        issue_number: Issue number
+        comment: Optional closing comment
+
+    Returns:
+        Updated issue information
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    # Add comment if provided
+    if comment:
+        comment_url = f'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}/comments'
+        requests.post(comment_url, headers=headers, json={'body': comment})
+    # Close the issue
+    data = {'state': 'closed'}
+    url = f'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}'
+    response = requests.patch(url, headers=headers, json=data)
+    if response.status_code == 200:
+        return response.json()
+    else:
+        return {'error': f'Failed to close issue: {response.status_code}'}
+
+@mcp.tool()
+def add_issue_comment(owner: str, repo: str, issue_number: int, comment: str) -> str:
+    """Add a comment to an issue
+
+    Args:
+        owner: Repository owner (username or organization)
+        repo: Repository name
+        issue_number: Issue number
+        comment: Comment text
+
+    Returns:
+        Created comment information
+    """
+    import requests
+    headers = {'Accept': 'application/vnd.github.v3+json'}
+    data = {'body': comment}
+    url = f'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}/comments'
+    response = requests.post(url, headers=headers, json=data)
+    if response.status_code == 201:
+        return response.json()
+    else:
+        return {'error': f'Failed to add comment: {response.status_code}'}
+
+@mcp.resource("docs://github-api/{endpoint}")
+def github_api_docs(endpoint: str) -> str:
+    """GitHub API documentation reference for issues and pull requests"""
+    docs = {
+        'issues': 'GitHub Issues API: https://docs.github.com/en/rest/issues',
+        'pulls': 'GitHub Pull Requests API: https://docs.github.com/en/rest/pulls',
+        'authentication': 'Use personal access tokens in headers: {"Authorization": "token YOUR_TOKEN"}',
+        'rate_limits': 'GitHub API rate limit: 5000 requests per hour for authenticated users'
+    }
+    endpoint = endpoint if endpoint in docs else 'issues'
+    return docs[endpoint]
+
+@mcp.resource("guide://workflow")
+def workflow_guide() -> str:
+    """Guide for using this MCP to close issues with PRs"""
+    return '''GitHub Issue-PR Workflow Guide:
+    
+    1. Get issue details: Use get_issue() to understand the problem
+    2. Find related PRs: Use list_issue_prs() to see existing work
+    3. Check PR status: Use get_pull_request() to verify PR readiness
+    4. Create PR if needed: Use create_pull_request() for new solutions
+    5. Merge when ready: Use merge_pull_request() for approved PRs
+    6. Close issue: Use close_issue() with a summary comment
+    7. Update stakeholders: Use add_issue_comment() for status updates
+    
+    Best Practices:
+    - Always check if PRs are mergeable and have passed checks
+    - Verify all required reviews are approved
+    - Add meaningful comments when closing issues
+    - Reference PR numbers when closing issues'''
+
+@mcp.prompt()
+def analyze_issue(owner: str, repo: str, issue_number: str) -> str:
+    """Analyze an issue and determine what actions are needed to resolve it
+
+    Args:
+        owner: Repository owner
+        repo: Repository name
+        issue_number: Issue number to analyze
+    """
+    return f"""Please analyze GitHub issue #{issue_number} in {owner}/{repo}. 
+
+1. First, get the issue details to understand the problem
+2. Check for any existing pull requests that might address this issue
+3. For each related PR, check its status and mergability
+4. Provide a summary of:
+   - What the issue is about
+   - Current status of any related PRs
+   - What actions are needed to close this issue
+   - Whether the issue can be closed now or what's blocking it
+
+Be thorough in your analysis and provide actionable recommendations."""
+
+@mcp.prompt()
+def close_issue_workflow(owner: str, repo: str, issue_number: str) -> str:
+    """Guide through the complete workflow to close an issue via PR
+
+    Args:
+        owner: Repository owner
+        repo: Repository name
+        issue_number: Issue number to close
+    """
+    return f"""Help me close GitHub issue #{issue_number} in {owner}/{repo} through the proper PR workflow:
+
+1. Analyze the issue and gather context
+2. Check for existing PRs that address this issue
+3. Evaluate if any PRs are ready to merge
+4. If PRs are ready and approved, merge them
+5. Close the issue with an appropriate comment
+6. Provide a summary of actions taken
+
+Please be careful to verify that PRs have passed all checks and have proper approvals before merging. If anything is not ready, explain what needs to happen next."""
+
+def main():
+    """Entry point for the MCP server."""
+    mcp.run()
+
+if __name__ == "__main__":
+    main()

github_issue_pr_manager-0.1.0.dist-info/METADATA

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: github-issue-pr-manager
+Version: 0.1.0
+Summary: MCP server for managing GitHub issues and pull requests, providing AI agents with tools to gather context and close issues through PR workflows
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.0.0
+Description-Content-Type: text/markdown
+
+# GitHub Issue PR Manager
+
+MCP server for managing GitHub issues and pull requests, providing AI agents with tools to gather context and close issues through PR workflows
+
+## Installation
+
+```bash
+uvx github-issue-pr-manager
+```
+
+## Tools
+
+- `get_issue`: Get detailed information about a GitHub issue including comments and linked PRs
+- `list_issue_prs`: List all pull requests that reference or are linked to a specific issue
+- `get_pull_request`: Get detailed information about a pull request including its status and mergability
+- `list_repository_prs`: List pull requests in a repository with optional filtering by state
+- `create_pull_request`: Create a new pull request
+- `merge_pull_request`: Merge a pull request if it's ready
+- `close_issue`: Close an issue and optionally add a closing comment
+- `add_issue_comment`: Add a comment to an issue
+
+## Resources
+
+- `docs://github-api/{endpoint}`: GitHub API documentation reference for issues and pull requests
+- `guide://workflow`: Guide for using this MCP to close issues with PRs
+
+## Prompts
+
+- `analyze_issue`: Analyze an issue and determine what actions are needed to resolve it
+- `close_issue_workflow`: Guide through the complete workflow to close an issue via PR
+
+## Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "github-issue-pr-manager": {
+      "command": "uvx",
+      "args": ["github-issue-pr-manager"]
+    }
+  }
+}
+```
+
+---
+
+Generated with MCP Builder

github_issue_pr_manager-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+github_issue_pr_manager/__init__.py,sha256=pYdESZlUIJYwcaQLSepearpHwYxEYTAvReJYgCTEpAc,234
+github_issue_pr_manager/server.py,sha256=zLBLxdFcLxJr1SCLzCk65jHDI8bRZ1NwwNuE6nRlgc4,11102
+github_issue_pr_manager-0.1.0.dist-info/METADATA,sha256=ovN9VftRCKyho2IwjF1OY7Dfx7NXr71tYqgg5xfGoSU,1751
+github_issue_pr_manager-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+github_issue_pr_manager-0.1.0.dist-info/entry_points.txt,sha256=X7_hWYqtGIizRv6zdXU6pnG9lwrdo8PDmolzy38O-t4,73
+github_issue_pr_manager-0.1.0.dist-info/RECORD,,

github_issue_pr_manager-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

github_issue_pr_manager-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+github-issue-pr-manager = github_issue_pr_manager:main