Skip to content

feat: Add MCPB bundle for Claude Desktop installation #1837

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
triepod-ai wants to merge 1 commit into
base: main
Choose a base branch
from
+135 −0
Open

feat: Add MCPB bundle for Claude Desktop installation #1837

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions .mcpbignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Source code - not needed for binary bundle
*.go
go.mod
go.sum

# Build and development
cmd/
internal/
pkg/
script/
e2e/
e2e.test
.vscode/
.github/
.golangci.yml
.goreleaser.yaml
Dockerfile
.dockerignore

# Documentation (keep README for reference)
docs/
CONTRIBUTING.md
CODE_OF_CONDUCT.md
SECURITY.md
SUPPORT.md
third-party-licenses.*.md
third-party/

# Git
.git/
.gitignore

# Misc
server.json
gemini-extension.json

# Keep only:
# - manifest.json
# - icon.png
# - bin/ (with all binaries)
# - README.md
# - LICENSE
Binary file added github-mcp-server-0.28.1.mcpb
View file
Open in desktop
Binary file not shown.
Binary file added icon.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
93 changes: 93 additions & 0 deletions manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
{
"manifest_version": "0.3",
"name": "GitHub MCP Server",
"version": "0.28.1",
Copy link

Copilot AI Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The version "0.28.1" appears to be hardcoded and may not match the actual release version. The project uses GoReleaser with version templating (see .goreleaser.yaml line 12 which sets version via ldflags), and server.json uses a VERSION template variable. Consider whether this version should be dynamically set during the build process to ensure consistency across all release artifacts, or document how this version should be maintained when new releases are created.

Suggested change
"version": "0.28.1",
"version": "VERSION",

Copilot uses AI. Check for mistakes.
"description": "GitHub's official MCP Server - access repositories, issues, pull requests, actions, and more",
"author": {
"name": "GitHub",
"url": "https://github.com/github"
},
"repository": {
"type": "git",
"url": "https://github.com/github/github-mcp-server"
},
"homepage": "https://github.com/github/github-mcp-server",
"documentation": "https://github.com/github/github-mcp-server#readme",
"support": "https://github.com/github/github-mcp-server/issues",
"privacy_policies": [
"https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement"
],
"icon": "icon.png",
"server": {
"type": "binary",
"entry_point": "bin/darwin-x64/github-mcp-server",
"mcp_config": {
"command": "${__dirname}/bin/darwin-x64/github-mcp-server",
"args": ["stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${user_config.github_token}",
"GITHUB_TOOLSETS": "${user_config.github_toolsets}",
"GITHUB_HOST": "${user_config.github_host}",
"GITHUB_READ_ONLY": "${user_config.github_read_only}",
"GITHUB_DYNAMIC_TOOLSETS": "${user_config.github_dynamic_toolsets}"
},
"platform_overrides": {
"win32": {
"command": "${__dirname}/bin/win32-x64/github-mcp-server.exe"
},
"linux": {
"command": "${__dirname}/bin/linux-x64/github-mcp-server"
}
}
Comment on lines +23 to +41
Copy link

Copilot AI Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The platform_overrides configuration only handles x64 architectures but the PR description claims "All 6 variants included" (darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-arm64, win32-x64). The current configuration will fail on ARM64 systems because:

  1. The default entry_point (line 23) and command (line 25) point to darwin-x64
  2. platform_overrides only specify win32 and linux without architecture variants
  3. No overrides exist for ARM64 architectures on any platform

This means ARM64 users will either get an error or the wrong binary will be executed. You need to add architecture-specific overrides or use a more sophisticated platform detection mechanism that handles both OS and architecture combinations.

Copilot uses AI. Check for mistakes.
}
},
"compatibility": {
"platforms": ["darwin", "win32", "linux"]
},
"user_config": {
"github_token": {
"type": "string",
"title": "GitHub Personal Access Token",
"description": "Create at github.com/settings/tokens with repo scope",
Copy link

Copilot AI Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The GitHub Personal Access Token description "Create at github.com/settings/tokens with repo scope" is incomplete. It doesn't mention that different scopes may be required depending on which toolsets are enabled. For example, the actions toolset requires "actions" scope, code_security requires "security_events" scope, etc. Consider providing a link to comprehensive documentation or listing the common scopes needed.

Suggested change
"description": "Create at github.com/settings/tokens with repo scope",
"description": "Create at github.com/settings/tokens. At minimum use the repo scope; additional scopes may be required for some toolsets (e.g., actions, security_events). See the README for full scope requirements.",

Copilot uses AI. Check for mistakes.
"required": true,
"sensitive": true
},
"github_toolsets": {
"type": "string",
"title": "Enabled Toolsets",
"description": "Comma-separated: repos,issues,pull_requests,users,actions,code_security,etc. Leave empty for defaults",
"required": false,
"default": ""
},
"github_host": {
"type": "string",
"title": "GitHub Host",
"description": "For GitHub Enterprise Server (e.g., github.mycompany.com). Leave empty for github.com",
Copy link

Copilot AI Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description for the GitHub Host configuration could be more specific. The format shown "github.mycompany.com" is missing the required "https://" prefix that the actual server code expects (as documented in the environment variables section). The description should specify the full format: "https://github.mycompany.com" to prevent user configuration errors.

Suggested change
"description": "For GitHub Enterprise Server (e.g., github.mycompany.com). Leave empty for github.com",
"description": "For GitHub Enterprise Server (must include \"https://\", e.g., https://github.mycompany.com). Leave empty for github.com",

Copilot uses AI. Check for mistakes.
"required": false,
"default": ""
},
"github_read_only": {
"type": "string",
"title": "Read-Only Mode",
"description": "Set to '1' to restrict to read-only operations (no create/update/delete)",
"required": false,
"default": ""
},
"github_dynamic_toolsets": {
"type": "string",
"title": "Dynamic Toolsets",
"description": "Set to '1' to enable dynamic tool discovery based on repo context",
"required": false,
"default": ""
}
},
"tools": [
{"name": "get_me", "description": "Get current authenticated user"},
{"name": "search_repositories", "description": "Search GitHub repositories"},
{"name": "get_repository", "description": "Get repository details"},
{"name": "list_issues", "description": "List issues in a repository"},
{"name": "create_issue", "description": "Create a new issue"},
{"name": "list_pull_requests", "description": "List pull requests"},
{"name": "create_pull_request", "description": "Create a pull request"}
]
Comment on lines +84 to +92
Copy link

Copilot AI Jan 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tools list only includes 7 sample tools, which is incomplete. According to the project documentation, the GitHub MCP Server provides many more tools across multiple toolsets (repos, issues, pull_requests, users, actions, code_security, etc.). While this might be intentional to show representative examples, it creates a discrepancy between what users see in the manifest and what's actually available. Consider either including all tools or clarifying in the description that this is a partial list.

Copilot uses AI. Check for mistakes.
}
Loading