github-mcp-connector 0.5.0__tar.gz → 0.7.0__tar.gz

{github_mcp_connector-0.5.0/src/github_mcp_connector.egg-info → github_mcp_connector-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.5.0
+Version: 0.7.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -31,10 +31,13 @@ Dynamic: license-file
 # GitHub MCP Connector
 
 A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that
-connects **Claude** to **GitHub**. It exposes a focused set of GitHub REST API
-operations as MCP tools, so Claude (Desktop, Code, or any MCP client) can read
-repositories, browse files and commit history, triage issues, review pull
-requests, and—optionally—open issues and post comments.
+connects **Claude** to **GitHub**. It exposes 50+ GitHub REST API operations as
+MCP tools, so Claude (Desktop, Code, or any MCP client) can search and read
+repositories, files, and commit history; triage and comment on issues; review,
+open, and merge pull requests; drive CI (read logs, re-run, dispatch); inspect
+security alerts; and—optionally—make changes (open/merge PRs, submit reviews,
+manage labels/assignees, commit files, cut releases). Every write is gated by a
+single read-only switch.
 
 It's a small, dependency-light Python package (`mcp` + `httpx`) that you point
 at a GitHub token. It supports both stdio (the default for Claude Desktop/Code)
@@ -43,14 +46,15 @@ Enterprise Server.
 
 ## Features
 
-- 🔍 **Search** repositories, issues/PRs, and code with GitHub's query syntax
+- 🔍 **Search & discover** repositories, issues/PRs, and code — plus find reusable repos (across everything your token can see, license/activity-aware) for what you're building
 - 📦 **Repositories** — metadata, branches, file contents, directory listings, your repo list
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
-- 🐛 **Issues** — list, read, create, comment, and edit/close
-- 🔀 **Pull requests** — list, read, fetch diffs/changed files, open new PRs, and merge
-- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run runs, list releases
-- 🔐 **Security** — list secret-scanning alerts; review PR reviews
-- ✍️ **Repo writes** — create branches and commit files (gated by read-only mode)
+- 🐛 **Issues** — list, read, create, comment, read comments, edit/close, label, assign
+- 🔀 **Pull requests** — list, read, diffs/files, comments, open, update, merge, and review
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch workflows, commit statuses & check runs, list/create releases
+- 🔐 **Security** — secret-scanning, code-scanning, and Dependabot alerts
+- 🔔 **Notifications** — list and mark read across all your repos
+- ✍️ **Repo writes** — create branches, commit files, manage labels/assignees, create gists (gated by read-only mode)
 - 🔒 **Read-only mode** — flip one env var to disable every write tool
 - 🏢 **Enterprise-friendly** — set `GITHUB_API_URL` for GitHub Enterprise Server
 
@@ -62,34 +66,53 @@ Enterprise Server.
 | `list_my_repositories` | List repos the token can access | |
 | `search_repositories` | Search repositories by query | |
 | `get_repository` | Repository metadata | |
+| `get_repository_tree` | Recursive file tree at a ref | |
 | `list_branches` | Branches with head commit SHAs | |
 | `get_file_contents` | Read a file (decoded) or list a directory | |
 | `list_commits` | Recent commits, optional branch/path filter | |
 | `get_commit` | A single commit with stats and changed files | |
 | `compare_commits` | Diff/ahead-behind between two refs | |
+| `get_combined_status` | Combined commit status for a ref | |
+| `list_check_runs` | Check runs for a ref | |
 | `list_issues` | Issues by state/labels | |
 | `get_issue` | A single issue with full body | |
+| `list_issue_comments` | Conversation comments on an issue/PR | |
 | `list_pull_requests` | Pull requests by state | |
 | `get_pull_request` | A single PR with body and merge status | |
 | `get_pull_request_diff` | Unified diff for a PR (truncated) | |
 | `list_pull_request_files` | Files changed in a PR | |
 | `list_pull_request_reviews` | Reviews submitted on a PR | |
+| `list_pull_request_review_comments` | Inline code-review comments on a PR | |
 | `list_workflow_runs` | Recent GitHub Actions runs | |
 | `list_workflow_run_jobs` | Jobs in a run (flags failed steps) | |
 | `get_job_logs` | Plain-text logs for a job (tail) | |
 | `list_releases` | Releases for a repository | |
+| `list_notifications` | Your notifications across all repos | |
 | `list_secret_scanning_alerts` | Secret-scanning alerts (no secret values) | |
+| `list_code_scanning_alerts` | Code-scanning (CodeQL) alerts | |
+| `list_dependabot_alerts` | Dependabot vulnerability alerts | |
 | `search_issues` | Search issues and PRs across GitHub | |
 | `search_code` | Search code across GitHub | |
+| `find_reusable_repositories` | Find reusable repos for what you're building (license/activity-aware; public + accessible private) | |
 | `create_pull_request` | Open a new pull request (supports draft) | ✅ |
+| `update_pull_request` | Edit title/body/base, close/reopen a PR | ✅ |
 | `merge_pull_request` | Merge a PR (merge/squash/rebase) | ✅ |
+| `submit_pull_request_review` | Approve / request changes / comment | ✅ |
+| `add_pull_request_review_comment` | Inline comment on a PR diff line | ✅ |
 | `rerun_workflow_run` | Re-run a workflow run (or just failed jobs) | ✅ |
+| `trigger_workflow` | Dispatch a workflow_dispatch run | ✅ |
+| `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
 | `add_issue_comment` | Comment on an issue or PR | ✅ |
+| `add_labels` | Add labels to an issue/PR | ✅ |
+| `remove_label` | Remove a label from an issue/PR | ✅ |
+| `add_assignees` | Assign users to an issue/PR | ✅ |
+| `mark_notification_read` | Mark a notification thread read | ✅ |
 | `create_branch` | Create a branch from a ref | ✅ |
 | `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
+| `create_gist` | Create a (secret or public) gist | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
 
@@ -105,9 +128,14 @@ Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
     account can access (public and private).
   - **Only specific repositories:** use a fine-grained PAT and select just those
     repos under "Repository access".
-  - **Permissions:** read access is enough for the read tools; to use the write
-    tools (`create_issue`, `add_issue_comment`) the token also needs issue
-    write access (classic: `repo`; fine-grained: *Issues → Read and write*).
+  - **Permissions:** read access is enough for the read tools. The write tools
+    need scopes matching what they touch — for a classic PAT the `repo` scope
+    covers most (issues, PRs, reviews, labels, assignees, branches, files,
+    releases, statuses), `workflow` is required for `trigger_workflow` /
+    `rerun_workflow_run`, and `gist` for `create_gist`. Fine-grained tokens need
+    the corresponding per-resource "Read and write" permissions (Contents,
+    Issues, Pull requests, Actions, etc.), and security-alert tools require the
+    relevant code-scanning/Dependabot/secret-scanning alert read permissions.
 
 ## Install from PyPI (recommended)
 

{github_mcp_connector-0.5.0 → github_mcp_connector-0.7.0}/README.md

@@ -1,10 +1,13 @@
 # GitHub MCP Connector
 
 A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that
-connects **Claude** to **GitHub**. It exposes a focused set of GitHub REST API
-operations as MCP tools, so Claude (Desktop, Code, or any MCP client) can read
-repositories, browse files and commit history, triage issues, review pull
-requests, and—optionally—open issues and post comments.
+connects **Claude** to **GitHub**. It exposes 50+ GitHub REST API operations as
+MCP tools, so Claude (Desktop, Code, or any MCP client) can search and read
+repositories, files, and commit history; triage and comment on issues; review,
+open, and merge pull requests; drive CI (read logs, re-run, dispatch); inspect
+security alerts; and—optionally—make changes (open/merge PRs, submit reviews,
+manage labels/assignees, commit files, cut releases). Every write is gated by a
+single read-only switch.
 
 It's a small, dependency-light Python package (`mcp` + `httpx`) that you point
 at a GitHub token. It supports both stdio (the default for Claude Desktop/Code)
@@ -13,14 +16,15 @@ Enterprise Server.
 
 ## Features
 
-- 🔍 **Search** repositories, issues/PRs, and code with GitHub's query syntax
+- 🔍 **Search & discover** repositories, issues/PRs, and code — plus find reusable repos (across everything your token can see, license/activity-aware) for what you're building
 - 📦 **Repositories** — metadata, branches, file contents, directory listings, your repo list
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
-- 🐛 **Issues** — list, read, create, comment, and edit/close
-- 🔀 **Pull requests** — list, read, fetch diffs/changed files, open new PRs, and merge
-- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run runs, list releases
-- 🔐 **Security** — list secret-scanning alerts; review PR reviews
-- ✍️ **Repo writes** — create branches and commit files (gated by read-only mode)
+- 🐛 **Issues** — list, read, create, comment, read comments, edit/close, label, assign
+- 🔀 **Pull requests** — list, read, diffs/files, comments, open, update, merge, and review
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch workflows, commit statuses & check runs, list/create releases
+- 🔐 **Security** — secret-scanning, code-scanning, and Dependabot alerts
+- 🔔 **Notifications** — list and mark read across all your repos
+- ✍️ **Repo writes** — create branches, commit files, manage labels/assignees, create gists (gated by read-only mode)
 - 🔒 **Read-only mode** — flip one env var to disable every write tool
 - 🏢 **Enterprise-friendly** — set `GITHUB_API_URL` for GitHub Enterprise Server
 
@@ -32,34 +36,53 @@ Enterprise Server.
 | `list_my_repositories` | List repos the token can access | |
 | `search_repositories` | Search repositories by query | |
 | `get_repository` | Repository metadata | |
+| `get_repository_tree` | Recursive file tree at a ref | |
 | `list_branches` | Branches with head commit SHAs | |
 | `get_file_contents` | Read a file (decoded) or list a directory | |
 | `list_commits` | Recent commits, optional branch/path filter | |
 | `get_commit` | A single commit with stats and changed files | |
 | `compare_commits` | Diff/ahead-behind between two refs | |
+| `get_combined_status` | Combined commit status for a ref | |
+| `list_check_runs` | Check runs for a ref | |
 | `list_issues` | Issues by state/labels | |
 | `get_issue` | A single issue with full body | |
+| `list_issue_comments` | Conversation comments on an issue/PR | |
 | `list_pull_requests` | Pull requests by state | |
 | `get_pull_request` | A single PR with body and merge status | |
 | `get_pull_request_diff` | Unified diff for a PR (truncated) | |
 | `list_pull_request_files` | Files changed in a PR | |
 | `list_pull_request_reviews` | Reviews submitted on a PR | |
+| `list_pull_request_review_comments` | Inline code-review comments on a PR | |
 | `list_workflow_runs` | Recent GitHub Actions runs | |
 | `list_workflow_run_jobs` | Jobs in a run (flags failed steps) | |
 | `get_job_logs` | Plain-text logs for a job (tail) | |
 | `list_releases` | Releases for a repository | |
+| `list_notifications` | Your notifications across all repos | |
 | `list_secret_scanning_alerts` | Secret-scanning alerts (no secret values) | |
+| `list_code_scanning_alerts` | Code-scanning (CodeQL) alerts | |
+| `list_dependabot_alerts` | Dependabot vulnerability alerts | |
 | `search_issues` | Search issues and PRs across GitHub | |
 | `search_code` | Search code across GitHub | |
+| `find_reusable_repositories` | Find reusable repos for what you're building (license/activity-aware; public + accessible private) | |
 | `create_pull_request` | Open a new pull request (supports draft) | ✅ |
+| `update_pull_request` | Edit title/body/base, close/reopen a PR | ✅ |
 | `merge_pull_request` | Merge a PR (merge/squash/rebase) | ✅ |
+| `submit_pull_request_review` | Approve / request changes / comment | ✅ |
+| `add_pull_request_review_comment` | Inline comment on a PR diff line | ✅ |
 | `rerun_workflow_run` | Re-run a workflow run (or just failed jobs) | ✅ |
+| `trigger_workflow` | Dispatch a workflow_dispatch run | ✅ |
+| `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
 | `add_issue_comment` | Comment on an issue or PR | ✅ |
+| `add_labels` | Add labels to an issue/PR | ✅ |
+| `remove_label` | Remove a label from an issue/PR | ✅ |
+| `add_assignees` | Assign users to an issue/PR | ✅ |
+| `mark_notification_read` | Mark a notification thread read | ✅ |
 | `create_branch` | Create a branch from a ref | ✅ |
 | `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
+| `create_gist` | Create a (secret or public) gist | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
 
@@ -75,9 +98,14 @@ Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
     account can access (public and private).
   - **Only specific repositories:** use a fine-grained PAT and select just those
     repos under "Repository access".
-  - **Permissions:** read access is enough for the read tools; to use the write
-    tools (`create_issue`, `add_issue_comment`) the token also needs issue
-    write access (classic: `repo`; fine-grained: *Issues → Read and write*).
+  - **Permissions:** read access is enough for the read tools. The write tools
+    need scopes matching what they touch — for a classic PAT the `repo` scope
+    covers most (issues, PRs, reviews, labels, assignees, branches, files,
+    releases, statuses), `workflow` is required for `trigger_workflow` /
+    `rerun_workflow_run`, and `gist` for `create_gist`. Fine-grained tokens need
+    the corresponding per-resource "Read and write" permissions (Contents,
+    Issues, Pull requests, Actions, etc.), and security-alert tools require the
+    relevant code-scanning/Dependabot/secret-scanning alert read permissions.
 
 ## Install from PyPI (recommended)
 

{github_mcp_connector-0.5.0 → github_mcp_connector-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-mcp-connector"
-version = "0.5.0"
+version = "0.7.0"
 description = "A Model Context Protocol (MCP) connector for GitHub, for use with Claude."
 readme = "README.md"
 requires-python = ">=3.10"

{github_mcp_connector-0.5.0 → github_mcp_connector-0.7.0}/src/github_mcp/client.py

@@ -136,9 +136,13 @@ class GitHubClient:
             return None
         return response.json()
 
-    async def delete(self, path: str) -> None:
-        # GitHub returns 204 No Content on a successful delete.
-        await self._request("DELETE", path)
+    async def delete(self, path: str) -> Any:
+        # GitHub returns 204 No Content for some deletes, but a body for others
+        # (e.g. removing an issue label returns the remaining labels).
+        response = await self._request("DELETE", path)
+        if not response.content:
+            return None
+        return response.json()
 
 
 def _extract_error_detail(response: httpx.Response) -> str: