# github-mcp

MCP server for the GitHub API. Uses the official Docker image from GitHub.

Source: [`ghcr.io/github/github-mcp-server`](https://github.com/github/github-mcp-server)

## Environment Variables

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

## Usage

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

This MCP uses stdio transport (no mcp-proxy). Clients connect directly via stdio.

## Tools

Repositories (CRUD, search, fork), pull requests (full lifecycle with reviews), issues (CRUD, search, comments), Actions (workflows, runs), file contents (read/write), commits, branches, users, releases.