mcp-github 0.2.0

MCP server that lets LLMs interact with GitHub repositories, issues, and pull requests
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

# mcp-github

MCP server that lets LLMs interact with GitHub repositories, issues, and pull requests. Single binary, read-only.

## Install

```bash
cargo install mcp-github
```

## Usage

```bash
# With token from environment (GITHUB_TOKEN)
mcp-github

# Explicit token
mcp-github --token ghp_xxxxx

# Default owner for all operations
mcp-github --owner myorg

# Custom results limit
mcp-github --owner myorg --max-results 50
```

## Configuration

### Claude Code

```bash
claude mcp add github -- mcp-github --owner myorg
```

### Claude Desktop

```json
{
  "mcpServers": {
    "github": {
      "command": "mcp-github",
      "args": ["--owner", "myorg"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxx"
      }
    }
  }
}
```

### Cursor / VS Code

```json
{
  "mcpServers": {
    "github": {
      "command": "mcp-github",
      "args": ["--owner", "myorg"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxx"
      }
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `list_repos` | List repositories for a user or organization |
| `get_repo` | Get repository info (stars, forks, language, default branch) |
| `list_issues` | List issues with state and label filters |
| `get_issue` | Get issue details with comments |
| `list_pulls` | List pull requests with state filter |
| `get_pull` | Get PR details with review summary and diff stats |
| `search_code` | Search code across repositories |
| `list_actions_runs` | List recent GitHub Actions workflow runs |

## CLI Options

| Flag | Default | Description |
|------|---------|-------------|
| `--token` | — | GitHub personal access token |
| `--token-env` | `GITHUB_TOKEN` | Environment variable containing the token |
| `--owner` | — | Default repository owner/org |
| `--max-results` | `30` | Maximum results per API call |

## Authentication

Token is resolved in this order:
1. `--token` flag
2. `--token-env` environment variable
3. `GITHUB_TOKEN` environment variable
4. Unauthenticated (rate limited to 60 requests/hour)

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or [MIT License](LICENSE-MIT) at your option.