github-enterprise-mcp 是 ddukbg 在 GitHub 上开发的一个 MCP(Model Context Protocol)服务器项目,用于与 GitHub Enterprise API 集成。它通过 MCP 接口,让用户在 Cursor 等 AI 工具中便捷地访问 GitHub Enterprise 中的仓库信息、议题(issues)、Pull Request(PR)等内容。
主要用途:该项目主要面向 GitHub Enterprise Server 环境,同时也适用于 GitHub Enterprise Cloud。需要注意的是,部分企业专属功能(如许可信息和企业统计)在 GitHub.com 或 GitHub Enterprise Cloud 上无法使用。
主要能力:
- 从 GitHub Enterprise 实例检索仓库列表
- 获取仓库详细信息
- 列出仓库分支
- 查看文件和目录内容
- 管理议题和 Pull Request
- 仓库管理(创建、更新、删除)
- GitHub Actions 工作流管理
- 用户管理(列出、创建、更新、删除、暂停/恢复用户)
- 访问企业统计信息
- 增强的错误处理和用户友好的响应格式化
使用方式: 前置条件:Node.js 18 或更高版本、可访问的 GitHub Enterprise 实例、个人访问令牌(PAT)。
Docker 安装与设置:
- 构建 Docker 镜像:docker build -t github-enterprise-mcp .
- 使用环境变量运行 Docker 容器:docker run -p 3000:3000 -e GITHUB_TOKEN="your_github_token" -e GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" -e DEBUG=true github-enterprise-mcp
- 说明:Dockerfile 默认配置为使用 --transport http 运行;如需更改,可覆盖命令。
- 在项目根目录创建 .env 文件,包含所需环境变量: GITHUB_ENTERPRISE_URL=https://github.your-company.com/api/v3 GITHUB_TOKEN=your_github_token DEBUG=true
- 使用 Docker Compose 启动容器:docker-compose up -d
- 查看日志:docker-compose logs -f
- 停止容器:docker-compose down
开发环境安装与设置:
- 克隆仓库并安装依赖: git clone https://github.com/ddukbg/github-enterprise-mcp.git cd github-enterprise-mcp npm install
- 运行开发服务器: export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" npm run dev 该命令会:在文件更改时自动编译 TypeScript 代码、在编译文件更新时重启服务器、以 HTTP 模式运行服务器以支持基于 URL 的连接。
- 按下文所述使用 URL 模式连接到 Cursor。
生产环境安装与设置:
- 构建项目:npm run build,然后 chmod +x dist/index.js
- 运行服务器: export GITHUB_TOKEN="your_github_token" export GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" node dist/index.js --transport http --debug
- 使用 URL 模式连接到 Cursor:在 Cursor 的 .cursor/mcp.json 文件中添加: { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse" } } }
本地开发方式:如果包已发布到公共 npm registry,也可使用 npx 方式。
与 AI 工具集成:
- 在 claude_desktop_config.json 中添加相关配置,将 YOUR_GITHUB_TOKEN 和 YOUR_GITHUB_ENTERPRISE_URL 替换为实际值。
- 在 Cursor 中,推荐使用 URL 模式以获得最可靠的操作: 在单独终端窗口启动服务器: cd /path/to/github-enterprise-mcp GITHUB_ENTERPRISE_URL="https://github.your-company.com/api/v3" GITHUB_TOKEN="your_github_token" node dist/index.js --transport http 配置 Cursor 的 MCP 设置:打开 Cursor 进入 Settings,导航至 AI > MCP Servers,编辑 .cursor/mcp.json 文件: { "mcpServers": { "github-enterprise": { "url": "http://localhost:3000/sse" } } } 重启 Cursor 以应用更改。
- 或者,也可以配置 Cursor 使用命令模式(URL 模式更可靠):点击 Add MCP Server,输入以下信息: Name:GitHub Enterprise Command:npx Arguments:@ddukbg/github-enterprise-mcp Environment Variables: GITHUB_ENTERPRISE_URL:你的 GitHub Enterprise API URL GITHUB_TOKEN:你的 GitHub 个人访问令牌 也可手动编辑 .cursor/mcp.json 文件进行配置。
语言配置: 该 MCP 服务器支持英语和韩语两种语言,可通过环境变量或命令行参数配置。未指定时默认语言为英语。
HTTP 模式附加选项:
- --debug:启用调试日志
- --github-enterprise-url <URL>:设置 GitHub Enterprise API URL
- --token <TOKEN>:设置 GitHub 个人访问令牌
- --language <LANG>:设置语言(en 或 ko,默认:en)
可用 MCP 工具: 该 MCP 服务器提供上述列出的工具。注意:对于企业专属工具(get-license-info 和 get-enterprise-stats),需要具有站点管理员权限的用户;推荐使用 Classic 个人访问令牌,因为 Fine-grained 令牌可能不支持这些企业级权限。
在 Cursor 中使用工具: 设置 MCP 服务器并配置 Cursor 连接后,可直接在 Cursor 的 AI 聊天中使用 GitHub Enterprise 工具,例如:列出仓库、获取仓库信息、列出 Pull Request、管理议题、处理仓库内容、仓库管理、用户管理(仅企业版)。这些功能专为 GitHub Enterprise Server 环境设计,需要管理员权限。
API 改进:
- 灵活的 API URL 配置(支持多种环境变量和命令行参数)
- 增强的错误处理和超时管理
- 用户友好的响应格式和消息