GitHub MCP自定义（跨平台NPX包装器）
的自定义打包版本 无缝运行 视窗, Linux，以及 macOS 通过 npx。这将Go二进制文件封装在Node.js启动器中，因此使用Claude Desktop的开发人员可以使用GitHub MCP功能，而无需Docker或手动编译。
______________________________________________________________________
📦 为什么存在
GitHub MCP服务器需要：
- Docker或
- 手动Go编译。
这些选项在Linux/macOS上运行良好，但是 破坏或复杂化Windows使用.
此软件包使服务器可通过以下方式使用 npx，消除了以下需求：
- 码头工人
- 开始安装
- 自定义路径设置
______________________________________________________________________
🧠 这个包有什么作用
- 提供跨平台
github-mcp-custom命令 - 通过Node.js包装器执行预构建的Go二进制文件
- 在所有操作系统上完全兼容NPX
- 使用Claude Desktop或其他MCP兼容工具即可开箱即用
- 与Claude Desktop兼容的协议版本
______________________________________________________________________
🚀 安装与使用
🔹 选项1：使用NPX运行（推荐）
npx -y github-mcp-custom@1.0.20 stdio首次使用将下载包并自动运行。
🔹 选项2：全局安装
npm install -g github-mcp-custom@1.0.20
github-mcp-custom stdio🔹 选项3：直接可执行文件（Windows回退）
如果NPX在Windows上有问题，请使用直接路径：
{
"mcpServers": {
"github": {
"command": "C:\\Users\\[USERNAME]\\AppData\\Roaming\\npm\\node_modules\\github-mcp-custom\\dist\\github-mcp-server.exe",
"args": ["stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}替换 [USERNAME] 使用您的实际Windows用户名。
注： 使用 @1.0.20 或更高版本，以获得最佳的克劳德桌面兼容性。
______________________________________________________________________
🛠️ 先决条件
- 必须安装v14或更高版本
- 具有适当作用域的活动GitHub个人访问令牌：
- repo （用于访问存储库） - read:org （用于组织访问） - user （供用户参考）
______________________________________________________________________
🔐 创建GitHub个人访问令牌
- 首选
- 点击“生成新令牌（经典）”
- 选择这些范围：
- ✅ repo -完全控制私有存储库 - ✅ read:org -阅读组织和团队成员 - ✅ user -更新用户数据
- 复制生成的令牌
______________________________________________________________________
🖥️ Claude桌面配置
视窗
将此添加到位于以下位置的Claude Desktop配置文件中： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "github-mcp-custom@1.0.20", "stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}macOS
将此添加到位于以下位置的Claude Desktop配置文件中： ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "github-mcp-custom@1.0.20", "stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}Linux
将此添加到位于以下位置的Claude Desktop配置文件中： ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "github-mcp-custom@1.0.20", "stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}备选全局安装配置
如果您已全局安装，则可以使用：
{
"mcpServers": {
"github": {
"command": "github-mcp-custom",
"args": ["stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}______________________________________________________________________
🎯 可用工具和功能
配置后，您将可以访问这些GitHub MCP工具：
📂 库管理
search_repositories-搜索GitHub存储库get_file_contents-从存储库读取文件内容create_or_update_file-创建/修改文件create_repository-创建新存储库fork_repository-Fork存储库create_branch-创建分支push_files-推送文件更改list_commits-查看提交历史记录get_commit-获取具体的提交详细信息
🐛 问题与项目管理
get_issue-获取带有时间戳的问题详细信息create_issue-创建新问题update_issue-更新问题（返回带有时间戳的更新信息）search_issues-跨问题搜索list_issues-列出存储库问题get_issue_comments-获取带有时间戳的问题注释add_issue_comment-为问题添加评论
🔀 拉取请求
get_pull_request-获取PR详细信息create_pull_request-创建新PRupdate_pull_request-更新现有PRmerge_pull_request- 合并 PRget_pull_request_files-查看PR更改get_pull_request_comments-获取公关评论create_and_submit_pull_request_review-审查PR
🔒 安全与扫描
list_code_scanning_alerts-代码安全警报list_secret_scanning_alerts-秘密扫描警报
🔔 通知
list_notifications-获取通知dismiss_notification-取消通知mark_all_notifications_read-将所有内容标记为已读
👤 用户和上下文
get_me-获取经过身份验证的用户详细信息search_users-搜索GitHub用户
______________________________________________________________________
🧪 测试您的设置
- 直接测试命令：
npx -y github-mcp-custom@1.0.20 stdio应输出： GitHub MCP Server running on stdio
- 使用Claude Desktop进行测试：
- 更新配置后重新启动Claude Desktop - 试着问：“你能得到我的GitHub用户信息吗？” - 克劳德应该能够使用 get_me 工具
______________________________________________________________________
🔧 故障排除
常见问题
❌ Claude Desktop中的“服务器已断开连接”
- 确保您使用的是版本
1.0.20或以后 - 检查您的GitHub令牌是否有效并且具有适当的作用域
- 验证JSON配置是否有效（没有尾随逗号）
❌ “找不到命令”
- 确保Node.js已安装并位于您的PATH中
- 试着跑步
npm --version验证npm是否正常工作
❌ “身份验证失败”
- 验证您的GitHub个人访问令牌是否正确
- 检查令牌是否具有所需的作用域(
repo,read:org,user) - 确保令牌未过期
❌ “找不到方法”错误
- 更新到最新版本：
npm install -g github-mcp-custom@latest
______________________________________________________________________
📁 文件结构
github-mcp-custom/
├── bin/
│ └── index.js # Node.js launcher
├── dist/
│ ├── github-mcp-server.exe # Windows binary
│ ├── github-mcp-server-macos # macOS binary
│ └── github-mcp-server-linux # Linux binary
├── package.json
└── README.md______________________________________________________________________
🖥️ 平台兼容性
| 平台 | 已测试 | 备注 |
|---|---|---|
| ✅ Windows 10/11 | ✔️ | 无需Docker或Go |
| ✅ Linux（Ubuntu） | ✔️ | 开箱即用 |
| ✅ macOS（英特尔/M1） | ✔️ | 轻松使用NPX |
______________________________________________________________________
📈 版本历史记录
- v1.0.20 -修复了Claude Desktop协议兼容性问题
- v1.0.16 -以前的版本（存在连接问题）
- v1.0.x -早期版本
______________________________________________________________________
👷 这是如何建造的
- 克隆了GitHub MCP Server官方存储库。
- 已更新协议版本以兼容Claude Desktop。
- 为所有平台编译的Go二进制文件：
GOOS=linux GOARCH=amd64 go build -o dist/github-mcp-server-linux ./cmd/github-mcp-server
GOOS=darwin GOARCH=amd64 go build -o dist/github-mcp-server-macos ./cmd/github-mcp-server
GOOS=windows GOARCH=amd64 go build -o dist/github-mcp-server.exe ./cmd/github-mcp-server- 创建了一个Node.js包装脚本(
bin/index.js)用于跨平台执行。 - 设置兼容NPM
package.json具有适当的料箱配置。 - 发布了包含协议兼容性修复程序的包。
______________________________________________________________________
🤝 贡献
欢迎投稿！请访问我们的GitHub仓库：
🔗 存储库： https://github.com/idletoaster/github-mcp-custom
- 🐛 报告问题：
- 💡 功能请求：
- 🔧 拉取请求： 欢迎改进和修复
开发设置
- 分叉并克隆存储库
- 安装依赖项：
go mod tidy - 生成二进制文件：
npm run build - 本地测试：
node bin/index.js stdio - 进行更改和测试
- 提交拉取请求
______________________________________________________________________
📜 许可证
MIT许可证
版权所有（c）2025 idletoaster
特此免费授予任何获得本软件和相关文档文件（“软件”）副本的人在不受限制的情况下处理软件的权限，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，以及允许获得软件的人这样做，但须符合以下条件：
上述版权声明和本许可声明应包含在软件的所有副本或实质部分中。
软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。