MCPs/github/README.md

github-mcp

MCP server for the GitHub API.

Source: @modelcontextprotocol/server-github (deprecated)

Environment Variables

Variable	Required	Description
GITHUB_PERSONAL_ACCESS_TOKEN	Yes	GitHub personal access token with repo + issues scopes

Usage

docker run -d \
  --name github-mcp \
  -p 8104:8104 \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=your_token \
  forgejo.corentic.eu/corentic/mcp-fleet-github:latest

Tools

Repositories

• create_repository — Create a GitHub repository. Params: name, description, private, autoInit
• search_repositories — Search for GitHub repositories. Params: query, search_options (sort, order, per_page, page)
• fork_repository — Fork a repository. Params: owner, repo, organization
• get_repository — Get repository details. Params: owner, repo
• list_repositories — List repositories for user/org. Params: owner, type, sort, direction, per_page, page

Pull Requests

• get_pull_request — Get PR details. Params: owner, repo, pull_number
• list_pull_requests — List PRs. Params: owner, repo, state, head, base, sort, direction, per_page, page
• create_pull_request — Create PR. Params: owner, repo, title, head, base, body, draft, maintainer_can_modify
• merge_pull_request — Merge PR. Params: owner, repo, pull_number, commit_title, commit_message, merge_method (merge/squash/rebase)
• get_pull_request_files — List changed files in a PR. Params: owner, repo, pull_number
• get_pull_request_status — Get combined status of all status checks for a PR. Params: owner, repo, pull_number
• update_pull_request_branch — Update PR branch with latest base branch. Params: owner, repo, pull_number, expected_head_sha
• get_pull_request_comments — List review comments on a PR. Params: owner, repo, pull_number
• create_pull_request_review — Create a review on a PR. Params: owner, repo, pull_number, body, event (APPROVE/REQUEST_CHANGES/COMMENT), comments[]
• list_pull_request_reviews — List reviews on a PR. Params: owner, repo, pull_number

Issues

• create_issue — Create issue. Params: owner, repo, title, body, assignees, labels, milestone
• list_issues — List issues. Params: owner, repo, state, labels, sort, direction, since, per_page, page
• add_issue_comment — Add comment. Params: owner, repo, issue_number, body
• search_issues — Search issues across GitHub. Params: q, sort, order, per_page, page
• get_issue — Get issue details. Params: owner, repo, issue_number
• update_issue — Update issue. Params: owner, repo, issue_number, title, body, state, labels, assignees, milestone

Actions

• list_workflows — List workflows in a repo. Params: owner, repo, per_page, page
• list_workflow_runs — List workflow runs. Params: owner, repo, workflow_id, branch, status, per_page, page
• get_workflow_run — Get workflow run details. Params: owner, repo, run_id
• get_workflow_run_usage — Get workflow run usage stats. Params: owner, repo, run_id

Contents

• get_content — Get file contents. Params: owner, repo, path, branch
• create_or_update_file — Create or update file. Params: owner, repo, path, content, message, branch, sha

Commits & Branches

• list_commits — List commits. Params: owner, repo, sha (branch), path, author, since, until, per_page, page
• get_commit — Get commit details. Params: owner, repo, ref
• list_branches — List branches. Params: owner, repo, protected, per_page, page
• create_branch — Create branch reference. Params: owner, repo, branch_name, sha

Users

• get_me — Get authenticated user profile
• search_users — Search users. Params: q

Releases

• list_releases — List releases. Params: owner, repo, per_page, page
• get_release — Get release by tag. Params: owner, repo, tag