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

github_mcp_agent-0.2.0/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.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: github-mcp-agent
+Version: 0.2.0
+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.
+
+```
+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** — uses your GitHub token, 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 `uv tool install .` from the project directory

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

@@ -14,9 +14,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
 ```
 
 ---

{github_mcp_agent-0.1.0 → github_mcp_agent-0.2.0}/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.0/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "github-mcp-agent"
+version = "0.2.0"
+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/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"