github-mcp-connector 0.2.0__tar.gz → 0.4.0__tar.gz

{github_mcp_connector-0.2.0/src/github_mcp_connector.egg-info → github_mcp_connector-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.2.0
+Version: 0.4.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -47,7 +47,7 @@ Enterprise Server.
 - 📦 **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 and changed files
+- 🔀 **Pull requests** — list, read, fetch diffs/changed files, open new PRs, and merge
 - ⚙️ **Actions & releases** — list workflow runs and releases
 - ✍️ **Repo writes** — create branches and commit files (gated by read-only mode)
 - 🔒 **Read-only mode** — flip one env var to disable every write tool
@@ -76,10 +76,13 @@ Enterprise Server.
 | `list_releases` | Releases for a repository | |
 | `search_issues` | Search issues and PRs across GitHub | |
 | `search_code` | Search code across GitHub | |
+| `create_pull_request` | Open a new pull request (supports draft) | ✅ |
+| `merge_pull_request` | Merge a PR (merge/squash/rebase) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
 | `add_issue_comment` | Comment on an issue or PR | ✅ |
 | `create_branch` | Create a branch from a ref | ✅ |
+| `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.

{github_mcp_connector-0.2.0 → github_mcp_connector-0.4.0}/README.md

@@ -17,7 +17,7 @@ Enterprise Server.
 - 📦 **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 and changed files
+- 🔀 **Pull requests** — list, read, fetch diffs/changed files, open new PRs, and merge
 - ⚙️ **Actions & releases** — list workflow runs and releases
 - ✍️ **Repo writes** — create branches and commit files (gated by read-only mode)
 - 🔒 **Read-only mode** — flip one env var to disable every write tool
@@ -46,10 +46,13 @@ Enterprise Server.
 | `list_releases` | Releases for a repository | |
 | `search_issues` | Search issues and PRs across GitHub | |
 | `search_code` | Search code across GitHub | |
+| `create_pull_request` | Open a new pull request (supports draft) | ✅ |
+| `merge_pull_request` | Merge a PR (merge/squash/rebase) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
 | `add_issue_comment` | Comment on an issue or PR | ✅ |
 | `create_branch` | Create a branch from a ref | ✅ |
+| `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.

{github_mcp_connector-0.2.0 → github_mcp_connector-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-mcp-connector"
-version = "0.2.0"
+version = "0.4.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.2.0 → github_mcp_connector-0.4.0}/src/github_mcp/client.py

@@ -136,6 +136,10 @@ 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)
+
 
 def _extract_error_detail(response: httpx.Response) -> str:
     """Pull the most useful human-readable error message out of a response."""

{github_mcp_connector-0.2.0 → github_mcp_connector-0.4.0}/src/github_mcp/server.py

@@ -695,6 +695,22 @@ async def create_branch(
     }
 
 
+@mcp.tool()
+async def delete_branch(owner: str, repo: str, branch: str) -> dict[str, Any]:
+    """Delete a branch from a repository.
+
+    `branch` is the branch name (e.g. `feature-x`, not `refs/heads/feature-x`).
+    This permanently removes the ref; it cannot delete the repository's default
+    branch (GitHub rejects that). Disabled in read-only mode; requires a token
+    with write access.
+    """
+    _require_token()
+    _require_write()
+    async with GitHubClient(config) as gh:
+        await gh.delete(f"/repos/{owner}/{repo}/git/refs/heads/{branch}")
+    return {"deleted": True, "branch": branch}
+
+
 @mcp.tool()
 async def create_or_update_file(
     owner: str,
@@ -748,6 +764,77 @@ async def create_or_update_file(
     }
 
 
+@mcp.tool()
+async def create_pull_request(
+    owner: str,
+    repo: str,
+    title: str,
+    head: str,
+    base: str,
+    body: str | None = None,
+    draft: bool = False,
+    maintainer_can_modify: bool = True,
+) -> dict[str, Any]:
+    """Open a new pull request.
+
+    `head` is the branch with your changes (for a cross-fork PR use
+    `owner:branch`); `base` is the branch you want to merge into (e.g. `main`).
+    Set `draft=True` to open it as a draft. Disabled in read-only mode; requires
+    a token with write access to the repository.
+    """
+    _require_token()
+    _require_write()
+    payload: dict[str, Any] = {
+        "title": title,
+        "head": head,
+        "base": base,
+        "draft": draft,
+        "maintainer_can_modify": maintainer_can_modify,
+    }
+    if body is not None:
+        payload["body"] = body
+    async with GitHubClient(config) as gh:
+        pull = await gh.post(f"/repos/{owner}/{repo}/pulls", json=payload)
+    summary = _summarize_pull(pull)
+    summary["body"] = pull.get("body")
+    return summary
+
+
+@mcp.tool()
+async def merge_pull_request(
+    owner: str,
+    repo: str,
+    pull_number: int,
+    merge_method: str = "merge",
+    commit_title: str | None = None,
+    commit_message: str | None = None,
+) -> dict[str, Any]:
+    """Merge a pull request.
+
+    `merge_method` is one of `merge` (merge commit), `squash`, or `rebase`.
+    `commit_title`/`commit_message` optionally override the merge commit text
+    (ignored for `rebase`). Fails if the PR isn't mergeable (conflicts, failing
+    required checks, or branch protection). Disabled in read-only mode; requires
+    a token with write access.
+    """
+    _require_token()
+    _require_write()
+    payload: dict[str, Any] = {"merge_method": merge_method}
+    if commit_title is not None:
+        payload["commit_title"] = commit_title
+    if commit_message is not None:
+        payload["commit_message"] = commit_message
+    async with GitHubClient(config) as gh:
+        result = await gh.put(
+            f"/repos/{owner}/{repo}/pulls/{pull_number}/merge", json=payload
+        )
+    return {
+        "merged": result.get("merged"),
+        "sha": result.get("sha"),
+        "message": result.get("message"),
+    }
+
+
 def main(argv: list[str] | None = None) -> None:
     """Console entry point. Selects the transport from CLI args/env."""
     import argparse

{github_mcp_connector-0.2.0 → github_mcp_connector-0.4.0/src/github_mcp_connector.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.2.0
+Version: 0.4.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -47,7 +47,7 @@ Enterprise Server.
 - 📦 **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 and changed files
+- 🔀 **Pull requests** — list, read, fetch diffs/changed files, open new PRs, and merge
 - ⚙️ **Actions & releases** — list workflow runs and releases
 - ✍️ **Repo writes** — create branches and commit files (gated by read-only mode)
 - 🔒 **Read-only mode** — flip one env var to disable every write tool
@@ -76,10 +76,13 @@ Enterprise Server.
 | `list_releases` | Releases for a repository | |
 | `search_issues` | Search issues and PRs across GitHub | |
 | `search_code` | Search code across GitHub | |
+| `create_pull_request` | Open a new pull request (supports draft) | ✅ |
+| `merge_pull_request` | Merge a PR (merge/squash/rebase) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
 | `add_issue_comment` | Comment on an issue or PR | ✅ |
 | `create_branch` | Create a branch from a ref | ✅ |
+| `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.

{github_mcp_connector-0.2.0 → github_mcp_connector-0.4.0}/tests/test_server.py

@@ -379,3 +379,118 @@ async def test_create_or_update_file_creates_new_on_404(monkeypatch):
     result = await server.create_or_update_file("o", "r", "new.md", "x", "add")
     assert "sha" not in captured["body"]  # no sha -> create
     assert result["created"] is True
+
+
+async def test_delete_branch_blocked_in_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(204), read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.delete_branch("o", "r", "feature")
+    assert exc.value.status_code == 403
+
+
+async def test_delete_branch_calls_correct_ref(monkeypatch):
+    captured = {}
+
+    def handler(request):
+        captured["method"] = request.method
+        captured["path"] = request.url.path
+        return httpx.Response(204)
+
+    install_mock(monkeypatch, handler)
+    result = await server.delete_branch("o", "r", "feature-x")
+    assert captured["method"] == "DELETE"
+    assert captured["path"] == "/repos/o/r/git/refs/heads/feature-x"
+    assert result == {"deleted": True, "branch": "feature-x"}
+
+
+async def test_delete_branch_surfaces_api_error(monkeypatch):
+    def handler(request):
+        return httpx.Response(422, json={"message": "Reference does not exist"})
+
+    install_mock(monkeypatch, handler)
+    with pytest.raises(GitHubError) as exc:
+        await server.delete_branch("o", "r", "missing")
+    assert exc.value.status_code == 422
+
+
+async def test_create_pull_request_blocked_in_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}),
+                 read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.create_pull_request("o", "r", "t", "feature", "main")
+    assert exc.value.status_code == 403
+
+
+async def test_create_pull_request_posts_payload(monkeypatch):
+    captured = {}
+
+    def handler(request):
+        import json
+        assert request.method == "POST"
+        assert request.url.path == "/repos/o/r/pulls"
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(
+            201,
+            json={
+                "number": 12,
+                "title": "t",
+                "state": "open",
+                "draft": True,
+                "body": "desc",
+                "head": {"ref": "feature"},
+                "base": {"ref": "main"},
+            },
+        )
+
+    install_mock(monkeypatch, handler)
+    result = await server.create_pull_request(
+        "o", "r", "t", "feature", "main", body="desc", draft=True
+    )
+    assert captured["body"]["title"] == "t"
+    assert captured["body"]["head"] == "feature"
+    assert captured["body"]["base"] == "main"
+    assert captured["body"]["draft"] is True
+    assert captured["body"]["body"] == "desc"
+    assert result["number"] == 12
+    assert result["draft"] is True
+    assert result["body"] == "desc"
+
+
+async def test_merge_pull_request_blocked_in_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}),
+                 read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.merge_pull_request("o", "r", 1)
+    assert exc.value.status_code == 403
+
+
+async def test_merge_pull_request_puts_payload(monkeypatch):
+    captured = {}
+
+    def handler(request):
+        import json
+        assert request.method == "PUT"
+        assert request.url.path == "/repos/o/r/pulls/5/merge"
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(
+            200, json={"merged": True, "sha": "abc", "message": "Pull Request successfully merged"}
+        )
+
+    install_mock(monkeypatch, handler)
+    result = await server.merge_pull_request(
+        "o", "r", 5, merge_method="squash", commit_title="T"
+    )
+    assert captured["body"]["merge_method"] == "squash"
+    assert captured["body"]["commit_title"] == "T"
+    assert result["merged"] is True
+    assert result["sha"] == "abc"
+
+
+async def test_merge_pull_request_surfaces_conflict(monkeypatch):
+    def handler(request):
+        return httpx.Response(405, json={"message": "Pull Request is not mergeable"})
+
+    install_mock(monkeypatch, handler)
+    with pytest.raises(GitHubError) as exc:
+        await server.merge_pull_request("o", "r", 5)
+    assert exc.value.status_code == 405