docs: Add `go install` as a first-class installation method
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 90/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- go
- Domain
- documentation
Research direction
Start in the README installation section, where Docker and building from source are currently described. Add the provided go install command and local MCP client configuration as a first-class method; done means readers can install the binary without cloning or using Docker and configure it to run with stdio.
Written by the indexing model from the issue text.
Description
[!Note]
Responses generated with Claude
Problem
The README currently documents Docker/container as the primary installation method, with "Build from source" (go build) as a fallback framed as "If you don't have Docker." There's no mention of go install, which is the standard one-liner for installing Go binaries.
Proposed change
Add go install alongside the container option as a first-class installation method:
go install github.com/github/github-mcp-server/cmd/github-mcp-server@latest
Then configure the MCP client to use the local binary:
{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
Why
- One command, no clone needed —
go installfetches, builds, and places the binary in$GOPATH/binin one step - Faster startup — no container overhead on each MCP server launch
- No Docker/Podman dependency — many developers have Go installed but not a container runtime
- Lower resource usage — containerized MCP servers consume memory even when idle, limiting the number of IDEs or agent terminals that can run concurrently. A native binary uses no resources when not actively handling a request.
- Safe — the binary only makes outbound HTTP calls to the GitHub API via stdio; container isolation adds no meaningful security benefit here
- Standard Go practice —
go installis the idiomatic way to distribute Go CLI tools
Verified
Tested on macOS (darwin/arm64):
$ go install github.com/github/github-mcp-server/cmd/github-mcp-server@latest
go: downloading github.com/github/github-mcp-server v1.0.1
$ github-mcp-server --version
GitHub MCP Server - Version: version
- Dominant language
- Go
- Stars
- 33.1k
- Forks
- 5k
- Avg merge
- 2d 1h
- Merged PRs (30d)
- 25
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/github-mcp-server
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
github/github-mcp-server#3235 ·
-
enhancement
Difficulty 1/5 Under an hour Newbie friendliness 88/100
github/github-mcp-server#3042 · 2 comments ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
github/github-mcp-server#3032 · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
github/github-mcp-server#2803 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
github/github-mcp-server#2740 ·
All issues in github/github-mcp-server
Similar issues
-
feature-request helm
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
gravitational/teleport#69785 ·
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
crossplane/crossplane#7859 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 90/100