github-mcp-agent 0.1.0__tar.gz → 0.2.1__tar.gz

{github_mcp_agent-0.1.0 → github_mcp_agent-0.2.1}/.gitignore

@@ -2,3 +2,5 @@
 .venv/
 __pycache__/
 *.pyc
+uv.lock
+dist/

github_mcp_agent-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar Hany
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

github_mcp_agent-0.2.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: github-mcp-agent
+Version: 0.2.1
+Summary: Talk to your GitHub repos, issues, and project boards in plain English from your terminal
+Project-URL: Homepage, https://github.com/OmarCodes022/GitHub-MCP-Agent
+Project-URL: Repository, https://github.com/OmarCodes022/GitHub-MCP-Agent
+Project-URL: Issues, https://github.com/OmarCodes022/GitHub-MCP-Agent/issues
+Author-email: Omar Hany <omarhanyabbas2004@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,cli,copilot,github,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: anthropic
+Requires-Dist: boto3
+Requires-Dist: click
+Requires-Dist: litellm
+Requires-Dist: mcp
+Requires-Dist: python-dotenv
+Requires-Dist: questionary
+Requires-Dist: rich
+Requires-Dist: strands-agents
+Description-Content-Type: text/markdown
+
+# GitHub MCP Agent
+
+Talk to your GitHub repos, issues, and project boards in plain English from your terminal.
+
+![GitHub MCP Agent demo](assets/demo1.png)
+
+```
+You > list open issues in my raytracer repo
+You > set priority of issue #42 to urgent
+You > what's in progress on the project board?
+You > which issues are assigned to maryam?
+```
+
+---
+
+## Install
+
+```bash
+pip install github-mcp-agent
+```
+
+Or with uv:
+
+```bash
+uv tool install github-mcp-agent
+```
+
+---
+
+## Setup
+
+```bash
+github-agent setup
+```
+
+Interactive wizard:
+
+1. GitHub token (validated immediately)
+2. AI provider — choose one:
+   - **AWS Bedrock** — existing profile, access keys, or SSO
+   - **Anthropic API** — API key from console.anthropic.com
+   - **OpenAI** — API key from platform.openai.com
+   - **Google Gemini** — API key from aistudio.google.com
+   - **GitHub Copilot** — browser OAuth flow, requires a Copilot subscription
+   - **Local (Ollama)** — picks from your installed models, no API key needed
+3. Model selection (scrollable menu)
+4. Pulls the GitHub MCP Docker image
+
+Config saved to `~/.config/github-mcp-agent/.env`.
+
+---
+
+## Usage
+
+```bash
+github-agent            # start the agent
+github-agent setup      # full setup wizard
+github-agent provider   # switch AI provider and model
+github-agent model      # switch model within current provider
+github-agent token      # update GitHub token
+github-agent config     # edit config file in $EDITOR
+github-agent prompt     # customize the system prompt in $EDITOR
+github-agent -v         # start with verbose tool output
+```
+
+---
+
+## Requirements
+
+| Requirement | Notes |
+|---|---|
+| Python 3.10+ | |
+| Docker | Must be running — used for the GitHub MCP server |
+| GitHub token | Scopes: `repo`, `read:org`, `project` — [github.com/settings/tokens](https://github.com/settings/tokens) |
+| Provider credentials | See setup wizard |
+
+**For AWS Bedrock:** enable Claude model access in the [Bedrock console](https://console.aws.amazon.com/bedrock) under Model access.
+
+**For Ollama:** install from [ollama.com](https://ollama.com), run `ollama serve`. Models with good tool-calling support: `qwen2.5`, `llama3.1`, `mistral`.
+
+**For GitHub Copilot:** requires an active Copilot subscription (student pack, individual, or business).
+
+---
+
+## How it works
+
+```
+You (terminal)
+    │
+    ▼
+github-agent (CLI)
+    │
+    ├── AI model (Bedrock / Anthropic / OpenAI / Gemini / Copilot / Ollama)
+    │
+    └── GitHub MCP Server (Docker)
+            │
+            └── GitHub API
+```
+
+Uses the [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with the [GitHub MCP server](https://github.com/github/github-mcp-server).
+
+---
+
+## Troubleshooting
+
+**`GITHUB_TOKEN` not set** — run `github-agent setup`
+
+**Docker not running** — start Docker Desktop or `sudo systemctl start docker`
+
+**Bedrock access denied** — check IAM permissions and model access in your region
+
+**Ollama model not found** — run `ollama list` to confirm the model name, re-run `github-agent model`
+
+**`No module named github_mcp_agent`** — reinstall with `pip install github-mcp-agent` or `uv tool install github-mcp-agent`

{github_mcp_agent-0.1.0 → github_mcp_agent-0.2.1}/README.md

@@ -2,6 +2,8 @@
 
 Talk to your GitHub repos, issues, and project boards in plain English from your terminal.
 
+![GitHub MCP Agent demo](assets/demo1.png)
+
 ```
 You > list open issues in my raytracer repo
 You > set priority of issue #42 to urgent
@@ -14,9 +16,13 @@ You > which issues are assigned to maryam?
 ## Install
 
 ```bash
-git clone https://github.com/OmarCodes022/GitHub-MCP-Agent
-cd GitHub-MCP-Agent
-uv tool install .   # or: pip install .
+pip install github-mcp-agent
+```
+
+Or with uv:
+
+```bash
+uv tool install github-mcp-agent
 ```
 
 ---
@@ -35,7 +41,7 @@ Interactive wizard:
    - **Anthropic API** — API key from console.anthropic.com
    - **OpenAI** — API key from platform.openai.com
    - **Google Gemini** — API key from aistudio.google.com
-   - **GitHub Copilot** — uses your GitHub token, requires a Copilot subscription
+   - **GitHub Copilot** — browser OAuth flow, requires a Copilot subscription
    - **Local (Ollama)** — picks from your installed models, no API key needed
 3. Model selection (scrollable menu)
 4. Pulls the GitHub MCP Docker image
@@ -105,4 +111,4 @@ Uses the [Strands Agents SDK](https://github.com/strands-agents/sdk-python) with
 
 **Ollama model not found** — run `ollama list` to confirm the model name, re-run `github-agent model`
 
-**`No module named github_mcp_agent`** — reinstall with `uv tool install .` from the project directory
+**`No module named github_mcp_agent`** — reinstall with `pip install github-mcp-agent` or `uv tool install github-mcp-agent`

{github_mcp_agent-0.1.0 → github_mcp_agent-0.2.1}/github_mcp_agent/providers/__init__.py

@@ -29,4 +29,3 @@ def setup(provider: str, _ask) -> dict:
     if mod is None:
         raise RuntimeError(f"Unknown provider: {provider}")
     return mod.setup(_ask)
-pypi-AgEIcHlwaS5vcmcCJGU0ZDI1YWQ5LTEyOGMtNDUyZi1iNmZkLTEzOWU0MmRkNDIzOAACKlszLCJjZTAzNzUyYy00ZjNhLTQ3MTYtYjM2ZS02YmY0ZGNhZjkyMDciXQAABiD04xa6bIcHRFlnmMHzKPunpg81Z6OhNO_P102kWxtY9g

github_mcp_agent-0.2.1/github_mcp_agent/providers/copilot.py

@@ -0,0 +1,117 @@
+import json
+import time
+import urllib.error
+import urllib.parse
+import urllib.request
+
+import questionary
+
+MODELS = [
+    ("gpt-4o", "gpt-4o", "flagship"),
+    ("gpt-4o-mini", "gpt-4o-mini", "fast, cheap"),
+    ("claude-sonnet-4-5", "claude-sonnet-4-5", "Anthropic via Copilot"),
+    ("o3-mini", "o3-mini", "reasoning"),
+    ("gemini-1.5-pro", "gemini-1.5-pro", "Google via Copilot"),
+]
+
+_CLIENT_ID = "Iv1.b507a08c87ecfe98"
+
+
+def _device_flow() -> str:
+    """Run GitHub device flow with the Copilot OAuth client, return an access token."""
+    from rich.console import Console
+    console = Console()
+
+    data = urllib.parse.urlencode({"client_id": _CLIENT_ID, "scope": "read:user"}).encode()
+    req = urllib.request.Request(
+        "https://github.com/login/device/code",
+        data=data,
+        headers={"Accept": "application/json"},
+    )
+    with urllib.request.urlopen(req) as r:
+        device = json.loads(r.read())
+
+    console.print(f"\n  Open: [bold cyan]{device['verification_uri']}[/bold cyan]")
+    console.print(f"  Code: [bold yellow]{device['user_code']}[/bold yellow]\n")
+
+    interval = device.get("interval", 5)
+    deadline = time.time() + device.get("expires_in", 900)
+
+    while time.time() < deadline:
+        time.sleep(interval)
+        poll_data = urllib.parse.urlencode({
+            "client_id": _CLIENT_ID,
+            "device_code": device["device_code"],
+            "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+        }).encode()
+        poll_req = urllib.request.Request(
+            "https://github.com/login/oauth/access_token",
+            data=poll_data,
+            headers={"Accept": "application/json"},
+        )
+        with urllib.request.urlopen(poll_req) as r:
+            result = json.loads(r.read())
+
+        if "access_token" in result:
+            return result["access_token"]
+        error = result.get("error", "")
+        if error == "slow_down":
+            interval += 5
+        elif error not in ("authorization_pending",):
+            raise RuntimeError(f"Auth failed: {result.get('error_description', error)}")
+
+    raise RuntimeError("Authentication timed out.")
+
+
+def _get_copilot_token(oauth_token: str) -> str:
+    """Exchange a Copilot OAuth token for a short-lived Copilot API token."""
+    req = urllib.request.Request("https://api.github.com/copilot_internal/v2/token")
+    req.add_header("Authorization", f"token {oauth_token}")
+    req.add_header("Accept", "application/json")
+    req.add_header("Editor-Version", "vscode/1.85.0")
+    req.add_header("Editor-Plugin-Version", "copilot/1.138.0")
+    req.add_header("User-Agent", "GithubCopilot/1.138.0")
+    try:
+        with urllib.request.urlopen(req) as r:
+            return json.loads(r.read())["token"]
+    except urllib.error.HTTPError as e:
+        raise RuntimeError(
+            f"Failed to get Copilot token (HTTP {e.code}).\n"
+            "Make sure you have an active Copilot subscription."
+        )
+
+
+def build_model(model_id: str):
+    import os
+    from strands.models.litellm import LiteLLMModel
+    oauth_token = os.environ.get("COPILOT_OAUTH_TOKEN")
+    if not oauth_token:
+        raise RuntimeError("Copilot token not set. Run 'github-agent provider' and pick GitHub Copilot.")
+    token = _get_copilot_token(oauth_token)
+    return LiteLLMModel(
+        model_id=f"openai/{model_id}",
+        params={
+            "api_base": "https://api.githubcopilot.com",
+            "api_key": token,
+            "extra_headers": {
+                "Editor-Version": "vscode/1.85.0",
+                "Editor-Plugin-Version": "copilot/1.138.0",
+                "User-Agent": "GithubCopilot/1.138.0",
+                "Copilot-Integration-Id": "vscode-chat",
+            },
+        },
+    )
+
+
+def setup(_ask) -> dict:
+    from rich.console import Console
+    console = Console()
+    console.print("  [dim]Requires an active Copilot subscription (student pack, individual, or business).[/dim]")
+    console.print("  [dim]Opening browser to authenticate with GitHub Copilot...[/dim]\n")
+
+    oauth_token = _device_flow()
+
+    model_choices = [f"{name}  ({desc})" for _, name, desc in MODELS]
+    model_display = _ask(questionary.select, "Model:", choices=model_choices)
+    model_id = MODELS[model_choices.index(model_display)][0]
+    return {"COPILOT_OAUTH_TOKEN": oauth_token, "MODEL_ID": model_id}

github_mcp_agent-0.2.1/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "github-mcp-agent"
+version = "0.2.1"
+description = "Talk to your GitHub repos, issues, and project boards in plain English from your terminal"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Omar Hany", email = "omarhanyabbas2004@gmail.com" }]
+keywords = ["github", "ai", "agent", "mcp", "cli", "copilot"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "boto3",
+    "strands-agents",
+    "mcp",
+    "rich",
+    "python-dotenv",
+    "questionary",
+    "anthropic",
+    "litellm",
+    "click",
+]
+
+[project.urls]
+Homepage = "https://github.com/OmarCodes022/GitHub-MCP-Agent"
+Repository = "https://github.com/OmarCodes022/GitHub-MCP-Agent"
+Issues = "https://github.com/OmarCodes022/GitHub-MCP-Agent/issues"
+
+[project.scripts]
+github-agent = "github_mcp_agent.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["github_mcp_agent"]
+
+[tool.hatch.build.targets.wheel.sources]
+"github_mcp_agent" = "github_mcp_agent"

github_mcp_agent-0.1.0/PKG-INFO

@@ -1,14 +0,0 @@
-Metadata-Version: 2.4
-Name: github-mcp-agent
-Version: 0.1.0
-Summary: A GitHub AI agent powered by AWS Bedrock and MCP
-Requires-Python: >=3.10
-Requires-Dist: anthropic
-Requires-Dist: boto3
-Requires-Dist: click
-Requires-Dist: litellm
-Requires-Dist: mcp
-Requires-Dist: python-dotenv
-Requires-Dist: questionary
-Requires-Dist: rich
-Requires-Dist: strands-agents

github_mcp_agent-0.1.0/github_mcp_agent/providers/copilot.py

@@ -1,32 +0,0 @@
-import os
-
-import questionary
-
-MODELS = [
-    ("gpt-4o", "gpt-4o", "flagship"),
-    ("gpt-4o-mini", "gpt-4o-mini", "fast, cheap"),
-    ("claude-sonnet-4-5", "claude-sonnet-4-5", "Anthropic via Copilot"),
-    ("o3-mini", "o3-mini", "reasoning"),
-    ("gemini-1.5-pro", "gemini-1.5-pro", "Google via Copilot"),
-]
-
-
-def build_model(model_id: str):
-    from strands.models.litellm import LiteLLMModel
-    token = os.environ.get("GITHUB_TOKEN")
-    if not token:
-        raise RuntimeError("GITHUB_TOKEN is not set. Run 'github-agent setup' to configure.")
-    return LiteLLMModel(
-        model_id=f"openai/{model_id}",
-        params={"api_base": "https://api.githubcopilot.com", "api_key": token},
-    )
-
-
-def setup(_ask) -> dict:
-    from rich.console import Console
-    console = Console()
-    console.print("  [dim]Uses your GitHub token - no extra API key needed.[/dim]")
-    console.print("  [dim]Requires an active Copilot subscription (student pack, individual, or business).[/dim]")
-    model_choices = [f"{name}  ({desc})" for _, name, desc in MODELS]
-    model_display = _ask(questionary.select, "Model:", choices=model_choices)
-    return {"MODEL_ID": MODELS[model_choices.index(model_display)][0]}

github_mcp_agent-0.1.0/pyproject.toml

@@ -1,29 +0,0 @@
-[project]
-name = "github-mcp-agent"
-version = "0.1.0"
-description = "A GitHub AI agent powered by AWS Bedrock and MCP"
-requires-python = ">=3.10"
-dependencies = [
-    "boto3",
-    "strands-agents",
-    "mcp",
-    "rich",
-    "python-dotenv",
-    "questionary",
-    "anthropic",
-    "litellm",
-    "click",
-]
-
-[project.scripts]
-github-agent = "github_mcp_agent.cli:main"
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["github_mcp_agent"]
-
-[tool.hatch.build.targets.wheel.sources]
-"github_mcp_agent" = "github_mcp_agent"