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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.7.0
+Version: 0.9.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -46,15 +46,15 @@ Enterprise Server.
 
 ## Features
 
-- 🔍 **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
+- 🔍 **Search & discover** repositories, issues, PRs, commits, code, and users — plus find reusable repos (across everything your token can see, license/activity-aware) for what you're building
+- 📦 **Repositories** — metadata, branches, tags, file contents, directory listings, your repo list; create and fork repos
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **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
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** 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)
+- ✍️ **Repo writes** — create/fork repos, 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
 
@@ -92,7 +92,15 @@ Enterprise Server.
 | `list_code_scanning_alerts` | Code-scanning (CodeQL) alerts | |
 | `list_dependabot_alerts` | Dependabot vulnerability alerts | |
 | `search_issues` | Search issues and PRs across GitHub | |
+| `search_pull_requests` | Search PRs across GitHub (auto-adds `is:pr`) | |
+| `search_commits` | Search commits across GitHub | |
+| `search_users` | Search users and organizations | |
 | `search_code` | Search code across GitHub | |
+| `list_labels` | Labels defined in a repository | |
+| `list_tags` | Git tags with their commit SHAs | |
+| `get_tag` | Resolve a tag to its commit | |
+| `list_gists` | The authenticated user's gists | |
+| `get_latest_release` | A repository's latest published release | |
 | `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 | ✅ |
@@ -101,6 +109,7 @@ Enterprise Server.
 | `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_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
@@ -113,6 +122,9 @@ Enterprise Server.
 | `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 | `create_gist` | Create a (secret or public) gist | ✅ |
+| `create_repository` | Create a new repo (user or org) | ✅ |
+| `fork_repository` | Fork a repo to your account/an org | ✅ |
+| `create_label` | Create a label in a repository | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
 

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

@@ -16,15 +16,15 @@ Enterprise Server.
 
 ## Features
 
-- 🔍 **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
+- 🔍 **Search & discover** repositories, issues, PRs, commits, code, and users — plus find reusable repos (across everything your token can see, license/activity-aware) for what you're building
+- 📦 **Repositories** — metadata, branches, tags, file contents, directory listings, your repo list; create and fork repos
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **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
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** 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)
+- ✍️ **Repo writes** — create/fork repos, 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,7 +62,15 @@ Enterprise Server.
 | `list_code_scanning_alerts` | Code-scanning (CodeQL) alerts | |
 | `list_dependabot_alerts` | Dependabot vulnerability alerts | |
 | `search_issues` | Search issues and PRs across GitHub | |
+| `search_pull_requests` | Search PRs across GitHub (auto-adds `is:pr`) | |
+| `search_commits` | Search commits across GitHub | |
+| `search_users` | Search users and organizations | |
 | `search_code` | Search code across GitHub | |
+| `list_labels` | Labels defined in a repository | |
+| `list_tags` | Git tags with their commit SHAs | |
+| `get_tag` | Resolve a tag to its commit | |
+| `list_gists` | The authenticated user's gists | |
+| `get_latest_release` | A repository's latest published release | |
 | `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 | ✅ |
@@ -71,6 +79,7 @@ Enterprise Server.
 | `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_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
@@ -83,6 +92,9 @@ Enterprise Server.
 | `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 | `create_gist` | Create a (secret or public) gist | ✅ |
+| `create_repository` | Create a new repo (user or org) | ✅ |
+| `fork_repository` | Fork a repo to your account/an org | ✅ |
+| `create_label` | Create a label in a repository | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-mcp-connector"
-version = "0.7.0"
+version = "0.9.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.7.0 → github_mcp_connector-0.9.0}/src/github_mcp/server.py

@@ -12,6 +12,7 @@ variable ``GITHUB_MCP_READ_ONLY`` is truthy.
 from __future__ import annotations
 
 import base64
+import re
 from typing import Any
 from urllib.parse import quote
 
@@ -566,6 +567,142 @@ async def search_code(query: str, limit: int = 10) -> list[dict[str, Any]]:
     ]
 
 
+@mcp.tool()
+async def search_pull_requests(query: str, limit: int = 10) -> list[dict[str, Any]]:
+    """Search pull requests across GitHub (gh search prs).
+
+    Wraps GitHub's issue search with an `is:pr` qualifier added automatically, so
+    `query` only needs the PR-specific parts, e.g.
+    `repo:octocat/hello-world is:open review:required` or `author:octocat is:merged`.
+    Returns up to `limit` (max 50) pull requests.
+    """
+    _require_token()
+    limit = max(1, min(limit, 50))
+    full_query = query if "is:pr" in query else f"is:pr {query}"
+    async with GitHubClient(config) as gh:
+        result = await gh.get(
+            "/search/issues", params={"q": full_query, "per_page": limit}
+        )
+    return [_summarize_issue(item) for item in result.get("items", [])]
+
+
+@mcp.tool()
+async def search_commits(query: str, limit: int = 10) -> list[dict[str, Any]]:
+    """Search commits across GitHub (gh search commits).
+
+    Example queries: `repo:octocat/hello-world fix bug`, `author:octocat merge`,
+    `org:anthropics committer-date:>2024-01-01`. Returns up to `limit` (max 50)
+    commits.
+    """
+    _require_token()
+    limit = max(1, min(limit, 50))
+    async with GitHubClient(config) as gh:
+        result = await gh.get(
+            "/search/commits", params={"q": query, "per_page": limit}
+        )
+    return [_summarize_commit(item) for item in result.get("items", [])]
+
+
+@mcp.tool()
+async def search_users(query: str, limit: int = 10) -> list[dict[str, Any]]:
+    """Search for users and organizations on GitHub (gh search users).
+
+    Example queries: `octocat`, `location:berlin language:python`,
+    `type:org anthropic`. Returns up to `limit` (max 50) accounts.
+    """
+    _require_token()
+    limit = max(1, min(limit, 50))
+    async with GitHubClient(config) as gh:
+        result = await gh.get(
+            "/search/users", params={"q": query, "per_page": limit}
+        )
+    return [
+        {
+            "login": item.get("login"),
+            "type": item.get("type"),
+            "html_url": item.get("html_url"),
+        }
+        for item in result.get("items", [])
+    ]
+
+
+@mcp.tool()
+async def list_labels(owner: str, repo: str, limit: int = 50) -> list[dict[str, Any]]:
+    """List the labels defined in a repository (gh label list).
+
+    Returns each label's name, color (hex, no leading `#`), and description, up to
+    `limit` (max 100).
+    """
+    _require_token()
+    limit = max(1, min(limit, 100))
+    async with GitHubClient(config) as gh:
+        labels = await gh.get(
+            f"/repos/{owner}/{repo}/labels", params={"per_page": limit}
+        )
+    return [
+        {
+            "name": label.get("name"),
+            "color": label.get("color"),
+            "description": label.get("description"),
+        }
+        for label in labels
+    ]
+
+
+@mcp.tool()
+async def list_tags(owner: str, repo: str, limit: int = 30) -> list[dict[str, Any]]:
+    """List git tags in a repository, with the commit SHA each points at."""
+    _require_token()
+    limit = max(1, min(limit, 100))
+    async with GitHubClient(config) as gh:
+        tags = await gh.get(f"/repos/{owner}/{repo}/tags", params={"per_page": limit})
+    return [
+        {
+            "name": tag.get("name"),
+            "sha": (tag.get("commit") or {}).get("sha"),
+        }
+        for tag in tags
+    ]
+
+
+@mcp.tool()
+async def get_tag(owner: str, repo: str, tag: str) -> dict[str, Any]:
+    """Resolve a single tag to its commit (the commit the tag ref points at).
+
+    `tag` is the tag name (e.g. `v1.2.0`). Works for both lightweight and
+    annotated tags; returns the underlying commit's SHA, message, and author.
+    """
+    _require_token()
+    async with GitHubClient(config) as gh:
+        commit = await gh.get(f"/repos/{owner}/{repo}/commits/tags/{quote(tag)}")
+    summary = _summarize_commit(commit)
+    summary["tag"] = tag
+    return summary
+
+
+@mcp.tool()
+async def list_gists(limit: int = 30) -> list[dict[str, Any]]:
+    """List the authenticated user's gists, most recent first (gh gist list)."""
+    _require_token()
+    limit = max(1, min(limit, 100))
+    async with GitHubClient(config) as gh:
+        gists = await gh.get("/gists", params={"per_page": limit})
+    return [_summarize_gist(gist) for gist in gists]
+
+
+@mcp.tool()
+async def get_latest_release(owner: str, repo: str) -> dict[str, Any]:
+    """Get a repository's latest published release (gh release view --latest).
+
+    Returns the most recent non-draft, non-prerelease release. Raises a 404 if the
+    repository has no published releases.
+    """
+    _require_token()
+    async with GitHubClient(config) as gh:
+        release = await gh.get(f"/repos/{owner}/{repo}/releases/latest")
+    return _summarize_release(release)
+
+
 @mcp.tool()
 async def list_my_repositories(
     affiliation: str = "owner,collaborator,organization_member",
@@ -1628,6 +1765,185 @@ async def create_gist(
     return _summarize_gist(gist)
 
 
+@mcp.tool()
+async def create_scheduled_workflow(
+    owner: str,
+    repo: str,
+    name: str,
+    cron: str,
+    run: str,
+    runs_on: str = "ubuntu-latest",
+    branch: str | None = None,
+    filename: str | None = None,
+    message: str | None = None,
+) -> dict[str, Any]:
+    """Schedule recurring work by committing a cron GitHub Actions workflow.
+
+    This is GitHub's native "do X later / on a schedule": it creates (or updates)
+    a workflow file at `.github/workflows/<filename>` that runs `run` (a shell
+    script) on the `cron` schedule, and also adds a `workflow_dispatch` trigger
+    so you can run it on demand. `cron` is standard 5-field UTC cron
+    (e.g. "0 9 * * 1" = 09:00 UTC every Monday).
+
+    IMPORTANT: GitHub only fires `schedule` triggers from a repository's DEFAULT
+    branch, so `branch` defaults to it — committing to another branch will run on
+    demand but never on the schedule. `filename` defaults to a slug of `name`.
+    Disabled in read-only mode; requires write access (and the token needs the
+    `workflow` scope to add workflow files).
+    """
+    _require_token()
+    _require_write()
+    if len(cron.split()) != 5:
+        raise GitHubError(
+            400,
+            "CRON",
+            f"/repos/{owner}/{repo}",
+            f"`cron` must be a 5-field cron expression (got: {cron!r}).",
+        )
+    slug = re.sub(r"[^a-z0-9]+", "-", name.lower()).strip("-") or "scheduled"
+    fname = filename or f"{slug}.yml"
+    path = f".github/workflows/{fname}"
+    indented_run = "\n".join("          " + line for line in run.splitlines())
+    content = (
+        f"name: {name}\n"
+        "on:\n"
+        "  schedule:\n"
+        f'    - cron: "{cron}"\n'
+        "  workflow_dispatch: {}\n"
+        "permissions:\n"
+        "  contents: read\n"
+        "jobs:\n"
+        "  scheduled:\n"
+        f"    runs-on: {runs_on}\n"
+        "    steps:\n"
+        "      - uses: actions/checkout@v4\n"
+        "      - name: Run scheduled command\n"
+        "        run: |\n"
+        f"{indented_run}\n"
+    )
+    encoded = base64.b64encode(content.encode("utf-8")).decode("ascii")
+    commit_message = message or f"Add scheduled workflow: {name}"
+    async with GitHubClient(config) as gh:
+        if branch is None:
+            repo_data = await gh.get(f"/repos/{owner}/{repo}")
+            branch = repo_data.get("default_branch")
+        payload: dict[str, Any] = {
+            "message": commit_message,
+            "content": encoded,
+            "branch": branch,
+        }
+        # If the workflow file already exists on this branch, update it.
+        try:
+            existing = await gh.get(
+                f"/repos/{owner}/{repo}/contents/{path}", params={"ref": branch}
+            )
+            if isinstance(existing, dict) and existing.get("sha"):
+                payload["sha"] = existing.get("sha")
+        except GitHubError as exc:
+            if exc.status_code != 404:
+                raise
+        result = await gh.put(f"/repos/{owner}/{repo}/contents/{path}", json=payload)
+    commit = result.get("commit", {})
+    content_info = result.get("content", {})
+    return {
+        "path": content_info.get("path", path),
+        "branch": branch,
+        "cron": cron,
+        "runs_on": runs_on,
+        "commit_sha": commit.get("sha"),
+        "html_url": content_info.get("html_url"),
+        "note": "Scheduled runs fire only from the default branch and start "
+        "from the next cron tick; use trigger_workflow to run it now.",
+    }
+
+
+@mcp.tool()
+async def create_repository(
+    name: str,
+    description: str | None = None,
+    private: bool = False,
+    org: str | None = None,
+    auto_init: bool = False,
+    homepage: str | None = None,
+) -> dict[str, Any]:
+    """Create a new repository (gh repo create).
+
+    Creates the repo under the authenticated user, or under `org` if given. Set
+    `auto_init=True` to seed an initial commit with a README (so the repo has a
+    default branch you can push to immediately). Disabled in read-only mode;
+    requires a token with the `repo` scope.
+    """
+    _require_token()
+    _require_write()
+    payload: dict[str, Any] = {"name": name, "private": private}
+    if description is not None:
+        payload["description"] = description
+    if homepage is not None:
+        payload["homepage"] = homepage
+    if auto_init:
+        payload["auto_init"] = True
+    path = f"/orgs/{org}/repos" if org else "/user/repos"
+    async with GitHubClient(config) as gh:
+        repo = await gh.post(path, json=payload)
+    return _summarize_repo(repo)
+
+
+@mcp.tool()
+async def fork_repository(
+    owner: str,
+    repo: str,
+    organization: str | None = None,
+    default_branch_only: bool = False,
+) -> dict[str, Any]:
+    """Fork a repository to your account or an organization (gh repo fork).
+
+    Forks `owner/repo` into the authenticated account, or into `organization` if
+    given. Set `default_branch_only=True` to fork just the default branch. The
+    fork is created asynchronously by GitHub, so it may take a moment to become
+    fully available. Disabled in read-only mode; requires write access.
+    """
+    _require_token()
+    _require_write()
+    payload: dict[str, Any] = {}
+    if organization is not None:
+        payload["organization"] = organization
+    if default_branch_only:
+        payload["default_branch_only"] = True
+    async with GitHubClient(config) as gh:
+        fork = await gh.post(f"/repos/{owner}/{repo}/forks", json=payload)
+    return _summarize_repo(fork)
+
+
+@mcp.tool()
+async def create_label(
+    owner: str,
+    repo: str,
+    name: str,
+    color: str | None = None,
+    description: str | None = None,
+) -> dict[str, Any]:
+    """Create a label in a repository (gh label create).
+
+    `color` is a 6-character hex code without the leading `#` (e.g. `d73a4a`); if
+    omitted GitHub assigns a default. Disabled in read-only mode; requires write
+    access.
+    """
+    _require_token()
+    _require_write()
+    payload: dict[str, Any] = {"name": name}
+    if color is not None:
+        payload["color"] = color.lstrip("#")
+    if description is not None:
+        payload["description"] = description
+    async with GitHubClient(config) as gh:
+        label = await gh.post(f"/repos/{owner}/{repo}/labels", json=payload)
+    return {
+        "name": label.get("name"),
+        "color": label.get("color"),
+        "description": label.get("description"),
+    }
+
+
 def main(argv: list[str] | None = None) -> None:
     """Console entry point. Selects the transport from CLI args/env."""
     import argparse

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.7.0
+Version: 0.9.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -46,15 +46,15 @@ Enterprise Server.
 
 ## Features
 
-- 🔍 **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
+- 🔍 **Search & discover** repositories, issues, PRs, commits, code, and users — plus find reusable repos (across everything your token can see, license/activity-aware) for what you're building
+- 📦 **Repositories** — metadata, branches, tags, file contents, directory listings, your repo list; create and fork repos
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **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
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** 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)
+- ✍️ **Repo writes** — create/fork repos, 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
 
@@ -92,7 +92,15 @@ Enterprise Server.
 | `list_code_scanning_alerts` | Code-scanning (CodeQL) alerts | |
 | `list_dependabot_alerts` | Dependabot vulnerability alerts | |
 | `search_issues` | Search issues and PRs across GitHub | |
+| `search_pull_requests` | Search PRs across GitHub (auto-adds `is:pr`) | |
+| `search_commits` | Search commits across GitHub | |
+| `search_users` | Search users and organizations | |
 | `search_code` | Search code across GitHub | |
+| `list_labels` | Labels defined in a repository | |
+| `list_tags` | Git tags with their commit SHAs | |
+| `get_tag` | Resolve a tag to its commit | |
+| `list_gists` | The authenticated user's gists | |
+| `get_latest_release` | A repository's latest published release | |
 | `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 | ✅ |
@@ -101,6 +109,7 @@ Enterprise Server.
 | `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_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |
@@ -113,6 +122,9 @@ Enterprise Server.
 | `delete_branch` | Delete a branch | ✅ |
 | `create_or_update_file` | Commit a file (create or update) | ✅ |
 | `create_gist` | Create a (secret or public) gist | ✅ |
+| `create_repository` | Create a new repo (user or org) | ✅ |
+| `fork_repository` | Fork a repo to your account/an org | ✅ |
+| `create_label` | Create a label in a repository | ✅ |
 
 Tools marked **Write** are disabled when `GITHUB_MCP_READ_ONLY` is set.
 

{github_mcp_connector-0.7.0 → github_mcp_connector-0.9.0}/tests/test_server.py

@@ -1056,3 +1056,232 @@ async def test_get_repository_tree_errors_without_default_branch(monkeypatch):
     with pytest.raises(GitHubError) as exc:
         await server.get_repository_tree("o", "r")
     assert exc.value.status_code == 404
+
+
+async def test_create_scheduled_workflow_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}),
+                 read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.create_scheduled_workflow("o", "r", "Nightly", "0 9 * * *",
+                                               "echo hi")
+    assert exc.value.status_code == 403
+
+
+async def test_create_scheduled_workflow_bad_cron(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}))
+    with pytest.raises(GitHubError) as exc:
+        await server.create_scheduled_workflow("o", "r", "x", "not cron", "echo")
+    assert exc.value.status_code == 400
+
+
+async def test_create_scheduled_workflow_commits_yaml(monkeypatch):
+    import base64
+    captured = {}
+
+    def handler(request):
+        import json
+        p = request.url.path
+        if request.method == "GET" and p == "/repos/o/r":
+            return httpx.Response(200, json={"default_branch": "main"})
+        if request.method == "GET" and p.startswith("/repos/o/r/contents/"):
+            return httpx.Response(404, json={"message": "Not Found"})
+        if request.method == "PUT" and p == "/repos/o/r/contents/.github/workflows/nightly-backup.yml":
+            captured["body"] = json.loads(request.content)
+            captured["path"] = p
+            return httpx.Response(
+                201,
+                json={"content": {"path": ".github/workflows/nightly-backup.yml",
+                                  "sha": "s", "html_url": "u"},
+                      "commit": {"sha": "c"}},
+            )
+        raise AssertionError(f"unexpected {request.method} {p}")
+
+    install_mock(monkeypatch, handler)
+    result = await server.create_scheduled_workflow(
+        "o", "r", "Nightly Backup", "0 9 * * 1", "echo hi\nrun-backup.sh"
+    )
+    body = captured["body"]
+    assert body["branch"] == "main"  # defaulted to default branch
+    assert "sha" not in body  # new file
+    yaml = base64.b64decode(body["content"]).decode()
+    assert "schedule:" in yaml
+    assert 'cron: "0 9 * * 1"' in yaml
+    assert "workflow_dispatch: {}" in yaml
+    assert "run-backup.sh" in yaml
+    assert result["cron"] == "0 9 * * 1"
+    assert result["branch"] == "main"
+
+
+# --- gh-CLI parity tools ----------------------------------------------------
+
+
+async def test_search_pull_requests_adds_is_pr(monkeypatch):
+    captured = {}
+
+    def handler(request):
+        assert request.url.path == "/search/issues"
+        captured["q"] = request.url.params["q"]
+        return httpx.Response(200, json={"items": [{"number": 5, "title": "t",
+                                                    "state": "open"}]})
+
+    install_mock(monkeypatch, handler)
+    result = await server.search_pull_requests("repo:o/r is:open")
+    assert "is:pr" in captured["q"]
+    assert result[0]["number"] == 5
+
+
+async def test_search_pull_requests_no_double_is_pr(monkeypatch):
+    captured = {}
+
+    def handler(request):
+        captured["q"] = request.url.params["q"]
+        return httpx.Response(200, json={"items": []})
+
+    install_mock(monkeypatch, handler)
+    await server.search_pull_requests("is:pr author:me")
+    assert captured["q"].count("is:pr") == 1
+
+
+async def test_search_commits(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/search/commits"
+        return httpx.Response(200, json={"items": [
+            {"sha": "abc", "commit": {"message": "fix",
+                                      "author": {"name": "JD", "date": "2024"}}}]})
+
+    install_mock(monkeypatch, handler)
+    result = await server.search_commits("repo:o/r fix")
+    assert result[0]["sha"] == "abc"
+    assert result[0]["message"] == "fix"
+
+
+async def test_search_users(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/search/users"
+        return httpx.Response(200, json={"items": [
+            {"login": "octocat", "type": "User", "html_url": "u", "extra": 1}]})
+
+    install_mock(monkeypatch, handler)
+    result = await server.search_users("octocat")
+    assert result[0]["login"] == "octocat"
+    assert "extra" not in result[0]
+
+
+async def test_list_labels(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/repos/o/r/labels"
+        return httpx.Response(200, json=[
+            {"name": "bug", "color": "d73a4a", "description": "broken"}])
+
+    install_mock(monkeypatch, handler)
+    result = await server.list_labels("o", "r")
+    assert result[0]["name"] == "bug"
+    assert result[0]["color"] == "d73a4a"
+
+
+async def test_list_tags(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/repos/o/r/tags"
+        return httpx.Response(200, json=[
+            {"name": "v1.0", "commit": {"sha": "deadbeef"}}])
+
+    install_mock(monkeypatch, handler)
+    result = await server.list_tags("o", "r")
+    assert result[0]["name"] == "v1.0"
+    assert result[0]["sha"] == "deadbeef"
+
+
+async def test_get_tag_resolves_commit(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/repos/o/r/commits/tags/v1.2.0"
+        return httpx.Response(200, json={
+            "sha": "abc", "commit": {"message": "release",
+                                     "author": {"name": "JD", "date": "2024"}}})
+
+    install_mock(monkeypatch, handler)
+    result = await server.get_tag("o", "r", "v1.2.0")
+    assert result["tag"] == "v1.2.0"
+    assert result["sha"] == "abc"
+
+
+async def test_list_gists(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/gists"
+        return httpx.Response(200, json=[
+            {"id": "g1", "description": "d", "public": True,
+             "files": {"a.txt": {}}, "html_url": "u"}])
+
+    install_mock(monkeypatch, handler)
+    result = await server.list_gists()
+    assert result[0]["id"] == "g1"
+    assert result[0]["files"] == ["a.txt"]
+
+
+async def test_get_latest_release(monkeypatch):
+    def handler(request):
+        assert request.url.path == "/repos/o/r/releases/latest"
+        return httpx.Response(200, json={"tag_name": "v2.0", "name": "v2.0",
+                                         "draft": False, "prerelease": False})
+
+    install_mock(monkeypatch, handler)
+    result = await server.get_latest_release("o", "r")
+    assert result["tag_name"] == "v2.0"
+
+
+async def test_create_repository_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}),
+                 read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.create_repository("newrepo")
+    assert exc.value.status_code == 403
+
+
+async def test_create_repository_user_and_org(monkeypatch):
+    import json
+    captured = {}
+
+    def handler(request):
+        captured["path"] = request.url.path
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(201, json={"full_name": "me/newrepo",
+                                         "stargazers_count": 0})
+
+    install_mock(monkeypatch, handler)
+    await server.create_repository("newrepo", description="d", auto_init=True)
+    assert captured["path"] == "/user/repos"
+    assert captured["body"]["auto_init"] is True
+
+    await server.create_repository("newrepo", org="acme")
+    assert captured["path"] == "/orgs/acme/repos"
+
+
+async def test_fork_repository(monkeypatch):
+    import json
+    captured = {}
+
+    def handler(request):
+        assert request.url.path == "/repos/o/r/forks"
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(202, json={"full_name": "me/r",
+                                         "stargazers_count": 0})
+
+    install_mock(monkeypatch, handler)
+    result = await server.fork_repository("o", "r", organization="acme")
+    assert captured["body"]["organization"] == "acme"
+    assert result["full_name"] == "me/r"
+
+
+async def test_create_label_strips_hash(monkeypatch):
+    import json
+    captured = {}
+
+    def handler(request):
+        assert request.url.path == "/repos/o/r/labels"
+        captured["body"] = json.loads(request.content)
+        return httpx.Response(201, json={"name": "bug", "color": "d73a4a",
+                                         "description": "x"})
+
+    install_mock(monkeypatch, handler)
+    result = await server.create_label("o", "r", "bug", color="#d73a4a")
+    assert captured["body"]["color"] == "d73a4a"  # leading # stripped
+    assert result["name"] == "bug"