github-agent 0.2.55__tar.gz → 0.7.1__tar.gz

{github_agent-0.2.55/github_agent.egg-info → github_agent-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-agent
-Version: 0.2.55
+Version: 0.7.1
 Summary: GitHub Agent for MCP
 Author-email: Audel Rouhi <knucklessg1@gmail.com>
 License: MIT
@@ -9,10 +9,13 @@ Classifier: License :: Public Domain
 Classifier: Environment :: Console
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
+Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.31
+Requires-Dist: agent-utilities[agent,logfire]>=0.6.2
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
 Dynamic: license-file
 
 # GitHub Agent - A2A | AG-UI | MCP
@@ -38,7 +41,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 0.2.55*
+*Version: 0.7.1*
 
 ## Overview
 
@@ -222,3 +225,68 @@ docker-compose up -d
 
 ![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
 ![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
+
+
+## MCP Configuration Examples
+
+### 1. Standard IO (stdio) Deployment
+
+```json
+{
+  "mcpServers": {
+    "github-agent": {
+      "command": "uv",
+      "args": [
+        "run",
+        "github-mcp"
+      ],
+      "env": {
+        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
+        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
+        "CONTENTSTOOL": "True",
+        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>",
+        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
+        "GITHUB_URL": "<YOUR_GITHUB_URL>",
+        "GITHUB_VERIFY": "<YOUR_GITHUB_VERIFY>",
+        "ISSUETOOL": "True",
+        "PULLSTOOL": "True",
+        "REPOSTOOL": "True"
+      }
+    }
+  }
+}
+```
+
+### 2. Streamable HTTP (SSE) Deployment
+
+```json
+{
+  "mcpServers": {
+    "github-agent": {
+      "command": "uv",
+      "args": [
+        "run",
+        "github-mcp",
+        "--transport",
+        "http",
+        "--host",
+        "0.0.0.0",
+        "--port",
+        "8000"
+      ],
+      "env": {
+        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
+        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
+        "CONTENTSTOOL": "True",
+        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>",
+        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
+        "GITHUB_URL": "<YOUR_GITHUB_URL>",
+        "GITHUB_VERIFY": "<YOUR_GITHUB_VERIFY>",
+        "ISSUETOOL": "True",
+        "PULLSTOOL": "True",
+        "REPOSTOOL": "True"
+      }
+    }
+  }
+}
+```

github_agent-0.2.55/PKG-INFO → github_agent-0.7.1/README.md

@@ -1,20 +1,3 @@
-Metadata-Version: 2.4
-Name: github-agent
-Version: 0.2.55
-Summary: GitHub Agent for MCP
-Author-email: Audel Rouhi <knucklessg1@gmail.com>
-License: MIT
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: Public Domain
-Classifier: Environment :: Console
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: agent-utilities[agent,logfire]>=0.2.31
-Dynamic: license-file
-
 # GitHub Agent - A2A | AG-UI | MCP
 
 ![PyPI - Version](https://img.shields.io/pypi/v/github-agent)
@@ -38,7 +21,7 @@ Dynamic: license-file
 ![PyPI - Wheel](https://img.shields.io/pypi/wheel/github-agent)
 ![PyPI - Implementation](https://img.shields.io/pypi/implementation/github-agent)
 
-*Version: 0.2.55*
+*Version: 0.7.1*
 
 ## Overview
 
@@ -222,3 +205,68 @@ docker-compose up -d
 
 ![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
 ![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
+
+
+## MCP Configuration Examples
+
+### 1. Standard IO (stdio) Deployment
+
+```json
+{
+  "mcpServers": {
+    "github-agent": {
+      "command": "uv",
+      "args": [
+        "run",
+        "github-mcp"
+      ],
+      "env": {
+        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
+        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
+        "CONTENTSTOOL": "True",
+        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>",
+        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
+        "GITHUB_URL": "<YOUR_GITHUB_URL>",
+        "GITHUB_VERIFY": "<YOUR_GITHUB_VERIFY>",
+        "ISSUETOOL": "True",
+        "PULLSTOOL": "True",
+        "REPOSTOOL": "True"
+      }
+    }
+  }
+}
+```
+
+### 2. Streamable HTTP (SSE) Deployment
+
+```json
+{
+  "mcpServers": {
+    "github-agent": {
+      "command": "uv",
+      "args": [
+        "run",
+        "github-mcp",
+        "--transport",
+        "http",
+        "--host",
+        "0.0.0.0",
+        "--port",
+        "8000"
+      ],
+      "env": {
+        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
+        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
+        "CONTENTSTOOL": "True",
+        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>",
+        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
+        "GITHUB_URL": "<YOUR_GITHUB_URL>",
+        "GITHUB_VERIFY": "<YOUR_GITHUB_VERIFY>",
+        "ISSUETOOL": "True",
+        "PULLSTOOL": "True",
+        "REPOSTOOL": "True"
+      }
+    }
+  }
+}
+```

{github_agent-0.2.55 → github_agent-0.7.1}/github_agent/agent_server.py

@@ -1,8 +1,7 @@
 #!/usr/bin/python
-# coding: utf-8
+import logging
 import os
 import sys
-import logging
 import warnings
 
 from agent_utilities import (
@@ -13,7 +12,7 @@ from agent_utilities import (
     load_identity,
 )
 
-__version__ = "0.2.55"
+__version__ = "0.7.1"
 
 logging.basicConfig(
     level=logging.INFO,

github_agent-0.2.55/github_agent/api_wrapper.py → github_agent-0.7.1/github_agent/api_client.py

@@ -1,51 +1,52 @@
 #!/usr/bin/python
 
+import logging
 import re
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from typing import TypeVar
+
 import requests
 import urllib3
-import logging
-from typing import List, TypeVar, Tuple
-from pydantic import ValidationError
-from concurrent.futures import ThreadPoolExecutor, as_completed
 from agent_utilities.base_utilities import get_logger
+from pydantic import BaseModel, ValidationError
 
 logger = get_logger(__name__)
 
+from agent_utilities.core.decorators import require_auth
+from agent_utilities.core.exceptions import (
+    AuthError,
+    MissingParameterError,
+    ParameterError,
+    UnauthorizedError,
+)
+
 from github_agent.github_input_models import (
-    RepoModel,
-    IssueModel,
-    PullRequestModel,
-    ContentModel,
     BranchModel,
     CommitModel,
+    ContentModel,
+    IssueModel,
+    PullRequestModel,
+    RepoModel,
 )
 from github_agent.github_response_models import (
-    Repository,
-    Issue,
-    PullRequest,
-    Content,
     Branch,
     Commit,
+    Content,
+    Issue,
+    PullRequest,
+    Repository,
     Response,
 )
-from agent_utilities.decorators import require_auth
-from agent_utilities.exceptions import (
-    AuthError,
-    UnauthorizedError,
-    ParameterError,
-    MissingParameterError,
-)
-
-T = TypeVar("T")
 
+T = TypeVar("T", bound=BaseModel)
 
-class Api(object):
 
+class Api:
     def __init__(
         self,
         url: str = "https://api.github.com",
-        token: str = None,
-        proxies: dict = None,
+        token: str | None = None,
+        proxies: dict | None = None,
         verify: bool = True,
         debug: bool = False,
     ):
@@ -73,7 +74,6 @@ class Api(object):
         if token:
             self.headers["Authorization"] = f"Bearer {token}"
         else:
-
             logger.warning("No token provided for GitHub API")
 
         try:
@@ -84,20 +84,20 @@ class Api(object):
                 proxies=self.proxies,
             )
             if response.status_code in (401, 403):
-                logger.error(f"Authentication Error: {response.content}")
+                logger.error(f"Authentication Error: {response.text}")
                 raise AuthError if response.status_code == 401 else UnauthorizedError
         except requests.exceptions.RequestException as e:
             logger.error(f"Connection Error: {str(e)}")
 
     def _fetch_next_page(
         self, endpoint: str, model: T, header: dict, page: int
-    ) -> List[dict]:
+    ) -> list[dict]:
         """Fetch a single page of data from the specified endpoint"""
-        model.page = page
+        model.page = page  # type: ignore[attr-defined]
         model.model_post_init(None)
         response = self._session.get(
             url=f"{self.url}{endpoint}" if endpoint.startswith("/") else endpoint,
-            params=model.api_parameters,
+            params=model.api_parameters,  # type: ignore[attr-defined]
             headers=header,
             verify=self.verify,
             proxies=self.proxies,
@@ -119,7 +119,7 @@ class Api(object):
 
     def _fetch_all_pages(
         self, endpoint: str, model: T
-    ) -> Tuple[requests.Response, List[dict]]:
+    ) -> tuple[requests.Response, list[dict]]:
         """Generic method to fetch all pages with parallelization if possible"""
         all_data = []
 
@@ -127,7 +127,7 @@ class Api(object):
 
         response = self._session.get(
             url=initial_url,
-            params=model.api_parameters,
+            params=model.api_parameters,  # type: ignore[attr-defined]
             headers=self.headers,
             verify=self.verify,
             proxies=self.proxies,
@@ -142,14 +142,15 @@ class Api(object):
 
         total_pages = self._get_total_pages(response)
 
-        if not model.max_pages or model.max_pages == 0 or model.max_pages > total_pages:
-            model.max_pages = total_pages
-
-        if model.max_pages > 1:
+        max_pages = getattr(model, "max_pages", total_pages)
+        if not max_pages or max_pages == 0 or max_pages > total_pages:
+            max_pages = total_pages
+            model.max_pages = total_pages  # type: ignore[attr-defined]
 
+        if max_pages > 1:
             with ThreadPoolExecutor(max_workers=5) as executor:
                 futures = []
-                for page in range(2, model.max_pages + 1):
+                for page in range(2, max_pages + 1):
                     futures.append(
                         executor.submit(
                             self._fetch_next_page,
@@ -177,7 +178,7 @@ class Api(object):
             parsed_data = [Repository(**item) for item in data]
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
 
     @require_auth
     def get_repository(self, owner: str, repo: str) -> Response:
@@ -194,8 +195,8 @@ class Api(object):
             return Response(response=response, data=parsed_data)
         except requests.exceptions.HTTPError as e:
             if e.response.status_code == 404:
-                raise ParameterError(f"Repository {owner}/{repo} not found")
-            raise e
+                raise ParameterError(f"Repository {owner}/{repo} not found") from e
+            raise
 
     @require_auth
     def get_issues(self, **kwargs) -> Response:
@@ -210,7 +211,7 @@ class Api(object):
             parsed_data = [Issue(**item) for item in data]
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
 
     @require_auth
     def get_pull_requests(self, **kwargs) -> Response:
@@ -225,7 +226,7 @@ class Api(object):
             parsed_data = [PullRequest(**item) for item in data]
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
 
     @require_auth
     def get_contents(self, **kwargs) -> Response:
@@ -241,13 +242,14 @@ class Api(object):
             )
             response.raise_for_status()
             data = response.json()
+            parsed_data: list[Content] | Content
             if isinstance(data, list):
                 parsed_data = [Content(**item) for item in data]
             else:
                 parsed_data = Content(**data)
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
 
     @require_auth
     def get_branches(self, **kwargs) -> Response:
@@ -260,7 +262,7 @@ class Api(object):
             parsed_data = [Branch(**item) for item in data]
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e
 
     @require_auth
     def get_commits(self, **kwargs) -> Response:
@@ -273,4 +275,4 @@ class Api(object):
             parsed_data = [Commit(**item) for item in data]
             return Response(response=response, data=parsed_data)
         except ValidationError as e:
-            raise ParameterError(f"Invalid parameters: {e.errors()}")
+            raise ParameterError(f"Invalid parameters: {e.errors()}") from e

{github_agent-0.2.55 → github_agent-0.7.1}/github_agent/auth.py

@@ -2,12 +2,12 @@
 
 import os
 import threading
-from typing import Optional
 
 import requests
-from agent_utilities.base_utilities import to_boolean, get_logger
-from github_agent.api_wrapper import Api
-from agent_utilities.exceptions import AuthError, UnauthorizedError
+from agent_utilities.base_utilities import get_logger, to_boolean
+from agent_utilities.core.exceptions import AuthError, UnauthorizedError
+
+from github_agent.api_client import Api
 
 local = threading.local()
 logger = get_logger(__name__)
@@ -15,9 +15,9 @@ logger = get_logger(__name__)
 
 def get_client(
     instance: str = os.getenv("GITHUB_URL", "https://api.github.com"),
-    token: Optional[str] = os.getenv("GITHUB_TOKEN", None),
+    token: str | None = os.getenv("GITHUB_TOKEN", None),
     verify: bool = to_boolean(string=os.getenv("GITHUB_VERIFY", "True")),
-    config: Optional[dict] = None,
+    config: dict | None = None,
 ) -> Api:
     """
     Factory function to create the GitHub Api client.
@@ -45,22 +45,22 @@ def get_client(
         exchange_data = {
             "grant_type": "urn:ietf:params:oauth:grant-type:token-exchange",
             "subject_token": user_token,
-            "subject_token_type": "urn:ietf:params:oauth:token-type:access_token",
-            "requested_token_type": "urn:ietf:params:oauth:token-type:access_token",
+            "subject_token_type": "urn:ietf:params:oauth:token-type:access_token",  # nosec B105
+            "requested_token_type": "urn:ietf:params:oauth:token-type:access_token",  # nosec B105
             "audience": config["audience"],
             "scope": config["delegated_scopes"],
         }
         auth = (config["oidc_client_id"], config["oidc_client_secret"])
         try:
             response = requests.post(
-                config["token_endpoint"], data=exchange_data, auth=auth
+                config["token_endpoint"], data=exchange_data, auth=auth, timeout=30
             )
             response.raise_for_status()
             new_token = response.json()["access_token"]
             logger.info("Token exchange successful")
         except Exception as e:
             logger.error(f"Token exchange failed: {str(e)}")
-            raise RuntimeError(f"Token exchange failed: {str(e)}")
+            raise RuntimeError(f"Token exchange failed: {str(e)}") from e
 
         try:
             return Api(

{github_agent-0.2.55 → github_agent-0.7.1}/github_agent/github_input_models.py

@@ -1,6 +1,6 @@
-#!/usr/bin/python
+from typing import Any
 
-from typing import Union, List, Dict, Optional
+#!/usr/bin/python
 from pydantic import (
     BaseModel,
     Field,
@@ -12,12 +12,14 @@ class BaseModelWrapper(BaseModel):
     Base Model wrapping common functionalities.
     """
 
-    max_pages: Optional[int] = Field(
+    max_pages: int | None = Field(
         description="Max amount of pages to retrieve", default=None
     )
-    page: Optional[int] = Field(description="Pagination page", default=1)
-    per_page: Optional[int] = Field(description="Results per page", default=100)
-    api_parameters: Optional[Dict] = Field(description="API Parameters", default=None)
+    page: int | None = Field(description="Pagination page", default=1)
+    per_page: int | None = Field(description="Results per page", default=100)
+    api_parameters: dict[str, Any] = Field(
+        description="API Parameters", default_factory=dict
+    )
 
     def model_post_init(self, __context):
         self.api_parameters = {}
@@ -32,15 +34,13 @@ class RepoModel(BaseModelWrapper):
     Pydantic model for Repository requests.
     """
 
-    owner: Optional[str] = Field(
-        None, description="The account owner of the repository."
-    )
-    repo: Optional[str] = Field(None, description="The name of the repository.")
-    visibility: Optional[str] = Field(
+    owner: str | None = Field(None, description="The account owner of the repository.")
+    repo: str | None = Field(None, description="The name of the repository.")
+    visibility: str | None = Field(
         None, description="Can be one of all, public, or private."
     )
-    affiliation: Optional[str] = Field(None, description="Affiliation filter.")
-    type: Optional[str] = Field(
+    affiliation: str | None = Field(None, description="Affiliation filter.")
+    type: str | None = Field(
         None, description="Can be one of all, owner, public, private, member."
     )
 
@@ -61,25 +61,25 @@ class IssueModel(BaseModelWrapper):
 
     owner: str = Field(..., description="The account owner of the repository.")
     repo: str = Field(..., description="The name of the repository.")
-    issue_number: Optional[int] = Field(
+    issue_number: int | None = Field(
         None, description="The number that identifies the issue."
     )
-    state: Optional[str] = Field(
+    state: str | None = Field(
         None,
         description="Indicates the state of the issues to return. Can be either open, closed, or all.",
     )
-    labels: Optional[Union[str, List[str]]] = Field(
+    labels: str | list[str] | None = Field(
         None, description="A list of comma separated label names."
     )
-    assignee: Optional[str] = Field(
+    assignee: str | None = Field(
         None,
         description="Can be the name of a user. Use none for issues with no assigned user, and * for assigned issues to any user.",
     )
-    creator: Optional[str] = Field(None, description="The user that created the issue.")
-    mentioned: Optional[str] = Field(
+    creator: str | None = Field(None, description="The user that created the issue.")
+    mentioned: str | None = Field(
         None, description="A user that is mentioned in the issue."
     )
-    since: Optional[str] = Field(
+    since: str | None = Field(
         None, description="Only show notifications updated after the given time."
     )
 
@@ -105,22 +105,22 @@ class PullRequestModel(BaseModelWrapper):
 
     owner: str = Field(..., description="The account owner of the repository.")
     repo: str = Field(..., description="The name of the repository.")
-    pull_number: Optional[int] = Field(
+    pull_number: int | None = Field(
         None, description="The number that identifies the pull request."
     )
-    state: Optional[str] = Field(
+    state: str | None = Field(
         None, description="State of the PR. (open, closed, or all)"
     )
-    head: Optional[str] = Field(
+    head: str | None = Field(
         None,
         description="Filter pulls by head user or head organization and branch name in the format of user:ref-name or organization:ref-name.",
     )
-    base: Optional[str] = Field(None, description="Filter pulls by base branch name.")
-    sort: Optional[str] = Field(
+    base: str | None = Field(None, description="Filter pulls by base branch name.")
+    sort: str | None = Field(
         None,
         description="What to sort results by. Can be created, updated, popularity, long-running.",
     )
-    direction: Optional[str] = Field(
+    direction: str | None = Field(
         None, description="The direction of the sort. Can be asc or desc."
     )
 
@@ -146,7 +146,7 @@ class ContentModel(BaseModelWrapper):
     owner: str = Field(..., description="The account owner of the repository.")
     repo: str = Field(..., description="The name of the repository.")
     path: str = Field(..., description="The content path.")
-    ref: Optional[str] = Field(
+    ref: str | None = Field(
         None,
         description="The name of the commit/branch/tag. Default: the repository's default branch.",
     )
@@ -164,7 +164,7 @@ class BranchModel(BaseModelWrapper):
 
     owner: str = Field(..., description="The account owner of the repository.")
     repo: str = Field(..., description="The name of the repository.")
-    branch: Optional[str] = Field(None, description="The name of the branch.")
+    branch: str | None = Field(None, description="The name of the branch.")
 
     def model_post_init(self, __context):
         super().model_post_init(__context)
@@ -177,19 +177,19 @@ class CommitModel(BaseModelWrapper):
 
     owner: str = Field(..., description="The account owner of the repository.")
     repo: str = Field(..., description="The name of the repository.")
-    sha: Optional[str] = Field(
+    sha: str | None = Field(
         None, description="SHA or branch to start listing commits from."
     )
-    path: Optional[str] = Field(
+    path: str | None = Field(
         None, description="Only commits containing this file path will be returned."
     )
-    author: Optional[str] = Field(
+    author: str | None = Field(
         None, description="GitHub username or email address to filter by commit author."
     )
-    since: Optional[str] = Field(
+    since: str | None = Field(
         None, description="Only show notifications updated after the given time."
     )
-    until: Optional[str] = Field(
+    until: str | None = Field(
         None, description="Only show notifications updated before the given time."
     )