快速入门

若遇到 Git MCP 服务器连接问题，请按以下步骤操作：

1. 运行 诊断脚本 检测常见问题。
2. 遵循 连接检查清单 逐步验证配置。
3. 查看 日志分析 理解错误模式。
4. 根据 解决方案步骤 处理具体问题。

常见问题及解决方法

包名错误

确保使用正确的包名格式：

uvx modelcontextprotocol-git-server

或

npm install -g @modelcontextprotocol/git-server

端口冲突

修改配置中的端口号或关闭占用端口的进程：

export GIT_SERVER_PORT=3001

环境变量

根据 Git 提供商设置正确变量：

• GitHub: GITHUB_TOKEN
• GitLab: GITLAB_PERSONAL_ACCESS_TOKEN

完成修复后，验证连接：

uvx modelcontextprotocol-git-server --env GIT_SERVER_PORT=3001