raja_github_mcp 0.1.0__py3-none-any.whl

github_mcp/github_client.py

@@ -0,0 +1,13 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+TOKEN = os.getenv("GITHUB_TOKEN")
+
+HEADERS = {
+    "Authorization": f"Bearer {TOKEN}",
+    "Accept": "application/vnd.github+json"
+}
+
+BASE_URL = "https://api.github.com"

github_mcp/main.py

@@ -0,0 +1,7 @@
+#from github_mcp.tools import mcp   # write this when you are deploying 
+from .tools import mcp
+def main():
+    print("Starting GitHub MCP...")
+    mcp.run(transport="stdio")
+if __name__ == "__main__":
+    main()

github_mcp/test.py

@@ -0,0 +1,2 @@
+
+

github_mcp/tools.py

@@ -0,0 +1,324 @@
+from fastmcp import FastMCP
+from .github_client import HEADERS, BASE_URL
+import requests
+mcp = FastMCP()
+
+@mcp.tool()
+def list_repositories():
+    '''Returns all repositories of authenticated GitHUB user'''
+
+    responce = requests.get(
+        f"{BASE_URL}/user/repos",
+        headers = HEADERS
+    )
+    if responce.status_code !=200:
+        return f"Error : {responce.status_code}"
+    repos = []
+
+    for repo in responce.json():
+
+        repos.append({
+            "name": repo["name"],
+            "url": repo["html_url"],
+            "visibility": "Private" if repo["private"] else "Public"
+        })
+
+    return repos
+
+
+@mcp.tool()
+def list_issues(owner:str, repo:str):
+    '''Returns all the issues of the user repository'''
+
+    responce =requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}/issues",
+        headers = HEADERS
+    )
+    if responce.status_code != 200:
+        return f"Error:{responce.status_code}"
+    
+    issues =[]
+    for issue in responce.json():
+        if "pull_request" in issue:
+            continue
+
+        issues.append({
+            "id" :issue["id"],
+            "state":issue["state"],
+            "title":issue["title"],
+            "body":issue["body"],
+            "url":issue["html_url"]
+        })
+    
+    return issues
+
+@mcp.tool()
+def create_issue(owner:str, repo:str, title:str, body:str):
+    "This function Creates an issue with title and body in the repository of the owner"
+    
+    issue={"title":title,"body":body}
+    responce = requests.post(
+        f"{BASE_URL}/repos/{owner}/{repo}/issues",
+        json=issue,
+        headers=HEADERS
+    )
+    if responce.status_code != 201:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    return {
+        "message": "Issue created successfully",
+        "issue_url": responce.json()["html_url"]
+    }
+
+@mcp.tool()
+def close_issue(owner:str,repo:str,issue_number:int):
+    '''This function will close the issue using the issue number'''
+    update={"state":"closed"}
+    responce = requests.patch(
+        f"{BASE_URL}/repos/{owner}/{repo}/issues/{issue_number}",
+        json=update,
+        headers=HEADERS
+    )
+    if responce.status_code != 200:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    return {
+        "message": "Issue closed successfully",
+        "issue_url": responce.json()["html_url"]
+    }
+
+@mcp.tool()
+def reopen_issue(owner:str,repo:str,issue_number:int):
+    '''This function will reopen the issue using the issue number'''
+    
+    
+    update={"state":"open"}
+    responce = requests.patch(
+        f"{BASE_URL}/repos/{owner}/{repo}/issues/{issue_number}",
+        json=update,
+        headers=HEADERS
+    )
+    if responce.status_code != 200:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    return {
+        "message": "Issue reopened successfully",
+        "issue_url": responce.json()["html_url"]
+    }
+
+@mcp.tool()
+def comment_on_issue(owner:str,repo:str,issue_number:int,comment:str):
+    '''This function will create a comment on the issue using the issue number'''
+    
+    
+    comment={"body":comment}
+    responce = requests.post(
+        f"{BASE_URL}/repos/{owner}/{repo}/issues/{issue_number}/comments",
+        json=comment,
+        headers=HEADERS
+    )
+    if responce.status_code != 201:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    return {
+        "message": "Comment added successfully",
+        "issue_url": responce.json()["html_url"]
+    }
+
+
+@mcp.tool()
+def get_repository_details(owner:str,repo:str):
+    '''Returns the details of repository with repository name'''
+
+    responce = requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}",
+        headers = HEADERS
+    )
+    if responce.status_code !=200:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    repo_data = responce.json()
+    
+
+    
+
+    return{
+        "name": repo_data["name"],
+        "full_name": repo_data["full_name"],
+        "description": repo_data["description"],
+        "url": repo_data["html_url"],
+        "visibility": "Private" if repo_data["private"] else "Public",
+        "default_branch": repo_data["default_branch"],
+        "language": repo_data["language"],
+        "stars": repo_data["stargazers_count"],
+        "forks": repo_data["forks_count"],
+        "open_issues": repo_data["open_issues_count"],
+        "created_at": repo_data["created_at"],
+        "updated_at": repo_data["updated_at"],
+        "clone_url": repo_data["clone_url"]
+    }
+
+@mcp.tool()
+def create_repository(name:str,description:str,private:bool,auto_init:bool):
+    '''Use this tool to create a repository'''
+   
+    responce = requests.post(
+        f"{BASE_URL}/user/repos",
+        json={"name":name,"description":description,"private":private,"auto_init":auto_init},
+        headers = HEADERS
+    )
+    if responce.status_code!=201:
+        return {
+            "status": responce.status_code,
+            "error": responce.json()
+        }
+    else:
+        return{
+            "message":"Repository Created Successfully",
+            "issue_url":responce.json()['html_url'],
+            "clone_url": responce.json()["clone_url"]
+        }
+@mcp.tool()
+def list_branches(owner: str, repo: str):
+    """Returns all branches of a repository."""
+
+    response = requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}/branches",
+        headers=HEADERS
+    )
+
+    if response.status_code != 200:
+        return {
+            "status": response.status_code,
+            "error": response.json()
+        }
+
+    branches = []
+
+    for branch in response.json():
+        branches.append({
+            "name": branch["name"],
+            "protected": branch["protected"]
+        })
+
+    return branches
+
+@mcp.tool()
+def create_branch(owner: str, repo: str, branch_name: str):
+    """Creates a new branch."""
+
+    repo_response = requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}",
+        headers=HEADERS
+    )
+
+    if repo_response.status_code != 200:
+        return {
+            "status": repo_response.status_code,
+            "error": repo_response.json()
+        }
+
+    default_branch = repo_response.json()["default_branch"]
+
+    sha_response = requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}/git/ref/heads/{default_branch}",
+        headers=HEADERS
+    )
+
+    if sha_response.status_code != 200:
+        return {
+            "status": sha_response.status_code,
+            "error": sha_response.json()
+        }
+
+    sha = sha_response.json()["object"]["sha"]
+
+    create_response = requests.post(
+        f"{BASE_URL}/repos/{owner}/{repo}/git/refs",
+        json={
+            "ref": f"refs/heads/{branch_name}",
+            "sha": sha
+        },
+        headers=HEADERS
+    )
+
+    if create_response.status_code != 201:
+        return {
+            "status": create_response.status_code,
+            "error": create_response.json()
+        }
+
+    return {
+        "message": "Branch created successfully",
+        "branch": branch_name
+    }
+
+@mcp.tool()
+def list_pull_requests(owner: str, repo: str):
+    """Returns all pull requests."""
+
+    response = requests.get(
+        f"{BASE_URL}/repos/{owner}/{repo}/pulls",
+        headers=HEADERS
+    )
+
+    if response.status_code != 200:
+        return {
+            "status": response.status_code,
+            "error": response.json()
+        }
+
+    prs = []
+
+    for pr in response.json():
+        prs.append({
+            "number": pr["number"],
+            "title": pr["title"],
+            "state": pr["state"],
+            "url": pr["html_url"]
+        })
+
+    return prs
+
+@mcp.tool()
+def create_pull_request(
+    owner: str,
+    repo: str,
+    title: str,
+    body: str,
+    head: str,
+    base: str
+):
+    """Creates a pull request."""
+
+    response = requests.post(
+        f"{BASE_URL}/repos/{owner}/{repo}/pulls",
+        json={
+            "title": title,
+            "body": body,
+            "head": head,
+            "base": base
+        },
+        headers=HEADERS
+    )
+
+    if response.status_code != 201:
+        return {
+            "status": response.status_code,
+            "error": response.json()
+        }
+
+    return {
+        "message": "Pull request created successfully",
+        "pr_url": response.json()["html_url"]
+    }

raja_github_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: raja_github_mcp
+Version: 0.1.0
+Summary: An MCP server for GitHub repository, issue, branch, and pull request management.
+Author: Anna Vamsi Krishna Raja
+Keywords: mcp,model-context-protocol,github,ai-agent,fastmcp
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=3.4.2
+Requires-Dist: requests
+Requires-Dist: python-dotenv

raja_github_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+github_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+github_mcp/github_client.py,sha256=C5Mhz4956As_txwrYf-w2fAcW3u5LM3ghz5ggQJnHj4,226
+github_mcp/main.py,sha256=vfXFP-aInBuaudQk0YpkJlrnSxIa1lAKLISt3HsaCoM,212
+github_mcp/test.py,sha256=daEdpEyAJIa8b2VkCqSKcw8PaExcB6Qro80XNes_sHA,2
+github_mcp/tools.py,sha256=JyEaZUWGnbB0WrNxPYVV6pjW9mlpMQaPa_X8NqYSifo,8458
+raja_github_mcp-0.1.0.dist-info/METADATA,sha256=Bk665Qnd8_UHvJSMmoGXMH2npPsFlS1qKDh7xqFbptY,389
+raja_github_mcp-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+raja_github_mcp-0.1.0.dist-info/entry_points.txt,sha256=xxTejNUu9JW0uO-s7RB6woQ1b7lnLW0YjzcvQNeVyzc,52
+raja_github_mcp-0.1.0.dist-info/top_level.txt,sha256=Oz7KcY8SwRmG0rRos2vB8LycqcG5vapSkveK8aqQi0Q,11
+raja_github_mcp-0.1.0.dist-info/RECORD,,

raja_github_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

raja_github_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+github-mcp = github_mcp.main:main

raja_github_mcp-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+github_mcp