GitHub MCP 服务器 Repository not found 错误排查指南

概述

Repository not found 是 GitHub MCP 服务器常见的仓库访问错误 [^1]。这通常表示仓库不存在、无访问权限或仓库名称格式错误。

错误表现

Repository not found
404 Not Found
MCP error -32603: failed to get pull request comments: 404 Not Found

常见原因与解决方案

原因 1：私有仓库无访问权限

解决方案： 确保 Token 具有访问私有仓库的权限 [^2]。

• 在 GitHub Settings > Developer settings > Personal access tokens 中检查 Token 权限
• 确保勾选 repo 权限（访问私有仓库）
• Fine-grained Token 需要显式授权特定仓库

原因 2：仓库名称格式错误

解决方案： 使用正确的仓库名称格式 owner/repo。

• 错误：myrepo
• 正确：username/myrepo 或 org-name/repo-name

原因 3：仓库不存在或已删除

解决方案： 在浏览器中访问 https://github.com/owner/repo 确认仓库存在。

原因 4：Token 权限不足

解决方案： 检查 Token 是否包含 repo 或 read:org 权限。

验证仓库访问权限

使用 curl 测试仓库访问：

curl -H "Authorization: Bearer YOUR_TOKEN" \n  https://api.github.com/repos/owner/repo

参考来源

[^1]: GitHub Issue #727 - MCP GitHub Server 无法访问私有仓库问题
[^2]: GitHub Issue #735 - 私有仓库 PR 评论 404 错误
[^3]: GitHub Docs - Token 权限 - 官方 Token 权限说明