GitHub Enterprise MCP Server

GitHub Enterprise MCP Server

通过 GitHub API 实现与 GitHub 仓库的交互，允许通过自然语言命令进行文件操作、仓库管理、问题跟踪和代码搜索。

Category
访问服务器

README

GitHub Enterprise MCP 服务器

用于 GitHub API 的 MCP 服务器，支持文件操作、仓库管理、搜索功能等。

功能特性

  • 自动创建分支: 在创建/更新文件或推送更改时，如果分支不存在，则自动创建分支
  • 全面的错误处理: 针对常见问题提供清晰的错误消息
  • Git 历史记录保留: 操作保持正确的 Git 历史记录，而无需强制推送
  • 批量操作: 支持单文件和多文件操作
  • 高级搜索: 支持搜索代码、议题/PR 和用户

Cline 安装指南

本指南将帮助您在 Cline 中安装和配置 GitHub Enterprise MCP 服务器，使您能够直接通过 Cline 使用 GitHub API 功能。

前提条件

  1. 您的系统上已安装 Node.js
  2. 具有适当权限的 GitHub 个人访问令牌
  3. 您的系统上已安装 Cline

安装步骤

1. 克隆仓库

git clone https://github.com/yourusername/github-enterprise-mcp.git
cd github-enterprise-mcp

2. 安装依赖并构建

npm install
npm run build

这将在 dist 目录中创建编译后的 JavaScript 文件。

3. 创建 GitHub 个人访问令牌

  1. 转到 GitHub 个人访问令牌（在 GitHub 设置 > 开发者设置中）
  2. 点击 "Generate new token"（生成新令牌）
  3. 选择您希望此令牌访问的仓库（公共、全部或选择）
  4. 创建一个具有 repo 范围（“完全控制私有仓库”）的令牌
    • 或者，如果仅使用公共仓库，则仅选择 public_repo 范围
  5. 复制生成的令牌

4. 配置 Cline MCP 设置

对于 Cline VS Code 扩展

  1. 打开 VS Code

  2. 找到 Cline MCP 设置文件，位于：

    • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
    • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  3. 将 GitHub Enterprise MCP 服务器配置添加到 mcpServers 对象：

{
  "mcpServers": {
    "github-enterprise": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
        "GITHUB_API_URL": "https://api.github.com" // 对于 GitHub.com
        // 对于 GitHub Enterprise，请使用您的实例 URL，例如 "https://github.yourdomain.com/api/v3"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 /absolute/path/to/github-enterprise-mcp/dist/index.js 替换为构建的 index.js 文件的绝对路径。

对于 Claude 桌面应用

  1. 找到 Claude 桌面配置文件，位于：

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. 将 GitHub Enterprise MCP 服务器配置添加到 mcpServers 对象：

{
  "mcpServers": {
    "github-enterprise": {
      "command": "node",
      "args": [
        "/absolute/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
        "GITHUB_API_URL": "https://api.github.com" // 对于 GitHub.com
        // 对于 GitHub Enterprise，请使用您的实例 URL，例如 "https://github.yourdomain.com/api/v3"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

5. 重启 Cline

配置 MCP 设置后，重启 Cline（VS Code 或 Claude 桌面）以应用更改。

验证

要验证 GitHub Enterprise MCP 服务器是否已正确安装和配置，您可以要求 Cline 使用其中一个 GitHub 工具：

你能使用 GitHub Enterprise MCP 服务器搜索关键字为 "react" 的仓库吗？

Cline 应该能够使用 search_repositories 工具来搜索关键字为 "react" 的仓库。

使用 Cline 进行交互式安装

为了获得交互式安装体验，请将以下文本复制并粘贴到 Cline 中，它将指导您完成安装过程：

我希望你帮助我安装 GitHub Enterprise MCP 服务器。 我需要你做的是：

1. 首先，解释一下 GitHub Enterprise MCP 服务器是什么，以及它将赋予你什么能力。

2. 指导我完成安装过程：
   - 帮助我克隆仓库（如果我还没有克隆）
   - 帮助我安装依赖并构建项目
   - 如果我没有 GitHub 个人访问令牌，请指导我创建一个
   - 帮助我在 VS Code 或 Claude 桌面中配置 MCP 设置
   - 验证安装是否正常工作

3. 向我展示一些安装完成后如何使用 GitHub Enterprise MCP 服务器的示例。

请首先解释一下 GitHub Enterprise MCP 服务器是什么，以及它将允许你为我做什么。

使用示例

安装完成后，您可以要求 Cline 直接执行 GitHub 操作，例如：

  • "创建一个名为 'my-project' 的新仓库"
  • "搜索与机器学习相关的仓库"
  • "从我的 feature 分支创建一个到 main 分支的 pull request"
  • "获取仓库 X 中 README.md 文件的内容"
  • "列出我的仓库中的未解决问题"

故障排除

如果您在使用 GitHub Enterprise MCP 服务器时遇到问题：

  1. 检查 MCP 设置中 index.js 文件的路径是否正确
  2. 验证您的 GitHub 个人访问令牌是否具有必要的权限
  3. 确保 GitHub API URL 对于您的 GitHub 实例是正确的
  4. 检查日志中是否有任何错误消息

其他配置选项

GitHub API 版本

您可以通过添加 GITHUB_API_VERSION 环境变量来指定 GitHub API 版本：

"env": {
  "GITHUB_PERSONAL_ACCESS_TOKEN": "your-personal-access-token",
  "GITHUB_API_URL": "https://api.github.com",
  "GITHUB_API_VERSION": "2022-11-28"
}

企业身份验证

对于使用不同身份验证方法的 GitHub Enterprise 实例，您可能需要提供其他配置。 有关更多信息，请参阅 Octokit 文档。

工具

  1. create_or_update_file

    • 在仓库中创建或更新单个文件
    • 输入：
      • owner (string): 仓库所有者（用户名或组织）
      • repo (string): 仓库名称
      • path (string): 创建/更新文件的路径
      • content (string): 文件内容
      • message (string): 提交消息
      • branch (string): 在其中创建/更新文件的分支
      • sha (optional string): 被替换文件的 SHA（用于更新）
    • 返回：文件内容和提交详细信息

  2. push_files

    • 在单个提交中推送多个文件
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • branch (string): 要推送到的分支
      • files (array): 要推送的文件，每个文件都具有 path 和 content
      • message (string): 提交消息
    • 返回：更新后的分支引用

  3. search_repositories

    • 搜索 GitHub 仓库
    • 输入：
      • query (string): 搜索查询
      • page (optional number): 分页的页码
      • perPage (optional number): 每页结果数（最多 100 个）
    • 返回：仓库搜索结果

  4. create_repository

    • 创建一个新的 GitHub 仓库
    • 输入：
      • name (string): 仓库名称
      • description (optional string): 仓库描述
      • private (optional boolean): 仓库是否应为私有
      • autoInit (optional boolean): 使用 README 初始化
    • 返回：已创建的仓库详细信息

  5. get_file_contents

    • 获取文件或目录的内容
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • path (string): 文件/目录的路径
      • branch (optional string): 从哪个分支获取内容
    • 返回：文件/目录内容

  6. create_issue

    • 创建一个新议题
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • title (string): 议题标题
      • body (optional string): 议题描述
      • assignees (optional string[]): 要分配的用户名
      • labels (optional string[]): 要添加的标签
      • milestone (optional number): 里程碑编号
    • 返回：已创建的议题详细信息

  7. create_pull_request

    • 创建一个新的 pull request
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • title (string): PR 标题
      • body (optional string): PR 描述
      • head (string): 包含更改的分支
      • base (string): 要合并到的分支
      • draft (optional boolean): 创建为草稿 PR
      • maintainer_can_modify (optional boolean): 允许维护者编辑
    • 返回：已创建的 pull request 详细信息

  8. fork_repository

    • Fork 一个仓库
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • organization (optional string): 要 fork 到的组织
    • 返回：已 fork 的仓库详细信息

  9. create_branch

    • 创建一个新分支
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • branch (string): 新分支的名称
      • from_branch (optional string): 源分支（默认为仓库默认分支）
    • 返回：已创建的分支引用

  10. list_issues

    • 列出和筛选仓库议题
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • state (optional string): 按状态筛选（'open'、'closed'、'all'）
      • labels (optional string[]): 按标签筛选
      • sort (optional string): 按（'created'、'updated'、'comments'）排序
      • direction (optional string): 排序方向（'asc'、'desc'）
      • since (optional string): 按日期筛选（ISO 8601 时间戳）
      • page (optional number): 页码
      • per_page (optional number): 每页结果数
    • 返回：议题详细信息数组

  11. update_issue

    • 更新现有议题
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • issue_number (number): 要更新的议题编号
      • title (optional string): 新标题
      • body (optional string): 新描述
      • state (optional string): 新状态（'open' 或 'closed'）
      • labels (optional string[]): 新标签
      • assignees (optional string[]): 新受让人
      • milestone (optional number): 新里程碑编号
    • 返回：更新后的议题详细信息

  12. add_issue_comment

    • 向议题添加评论
    • 输入：
      • owner (string): 仓库所有者
      • repo (string): 仓库名称
      • issue_number (number): 要评论的议题编号
      • body (string): 评论文本
    • 返回：已创建的评论详细信息

  13. search_code

    • 搜索 GitHub 仓库中的代码
    • 输入：
      • q (string): 使用 GitHub 代码搜索语法的搜索查询
      • sort (optional string): 排序字段（仅 'indexed'）
      • order (optional string): 排序顺序（'asc' 或 'desc'）
      • per_page (optional number): 每页结果数（最多 100 个）
      • page (optional number): 页码
    • 返回：带有仓库上下文的代码搜索结果

  14. search_issues

    • 搜索议题和 pull request
    • 输入：
      • q (string): 使用 GitHub 议题搜索语法的搜索查询
      • sort (optional string): 排序字段（comments、reactions、created 等）
      • order (optional string): 排序顺序（'asc' 或 'desc'）
      • per_page (optional number): 每页结果数（最多 100 个）
      • page (optional number): 页码
    • 返回：议题和 pull request 搜索结果

  15. search_users

    • 搜索 GitHub 用户
    • 输入：
      • q (string): 使用 GitHub 用户搜索语法的搜索查询
      • sort (optional string): 排序字段（followers、repositories、joined）
      • order (optional string): 排序顺序（'asc' 或 'desc'）
      • per_page (optional number): 每页结果数（最多 100 个）
      • page (optional number): 页码
    • 返回：用户搜索结果

  16. list_commits

  • 获取仓库中某个分支的提交
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • page (optional string): 页码
    • per_page (optional string): 每页记录数
    • sha (optional string): 分支名称
  • 返回：提交列表
  1. get_issue
  • 获取仓库中议题的内容
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • issue_number (number): 要检索的议题编号
  • 返回：Github 议题对象和详细信息
  1. get_pull_request
  • 获取特定 pull request 的详细信息
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
  • 返回：Pull request 详细信息，包括 diff 和审核状态
  1. list_pull_requests
  • 列出和筛选仓库 pull request
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • state (optional string): 按状态筛选（'open'、'closed'、'all'）
    • head (optional string): 按 head 用户/组织和分支筛选
    • base (optional string): 按 base 分支筛选
    • sort (optional string): 按（'created'、'updated'、'popularity'、'long-running'）排序
    • direction (optional string): 排序方向（'asc'、'desc'）
    • per_page (optional number): 每页结果数（最多 100 个）
    • page (optional number): 页码
  • 返回：pull request 详细信息数组
  1. create_pull_request_review
  • 在 pull request 上创建审核
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
    • body (string): 审核评论文本
    • event (string): 审核操作（'APPROVE'、'REQUEST_CHANGES'、'COMMENT'）
    • commit_id (optional string): 要审核的提交的 SHA
    • comments (optional array): 行特定评论，每个评论都具有：
      • path (string): 文件路径
      • position (number): diff 中的行位置
      • body (string): 评论文本
  • 返回：已创建的审核详细信息
  1. merge_pull_request
  • 合并 pull request
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
    • commit_title (optional string): 合并提交的标题
    • commit_message (optional string): 合并提交的额外详细信息
    • merge_method (optional string): 合并方法（'merge'、'squash'、'rebase'）
  • 返回：合并结果详细信息
  1. get_pull_request_files
  • 获取 pull request 中更改的文件列表
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
  • 返回：已更改的文件数组，带有 patch 和状态详细信息
  1. get_pull_request_status
  • 获取 pull request 的所有状态检查的组合状态
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
  • 返回：组合状态检查结果和单个检查详细信息
  1. update_pull_request_branch
  • 使用 base 分支的最新更改更新 pull request 分支（相当于 GitHub 的“更新分支”按钮）
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
    • expected_head_sha (optional string): pull request 的 HEAD ref 的预期 SHA
  • 返回：分支更新时的成功消息
  1. get_pull_request_comments
  • 获取 pull request 上的审核评论
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
  • 返回：pull request 审核评论数组，带有评论文本、作者和 diff 中的位置等详细信息
  1. get_pull_request_reviews
  • 获取 pull request 上的审核
  • 输入：
    • owner (string): 仓库所有者
    • repo (string): 仓库名称
    • pull_number (number): Pull request 编号
  • 返回：pull request 审核数组，带有审核状态（APPROVED、CHANGES_REQUESTED 等）、审核者和审核正文等详细信息

搜索查询语法

代码搜索

  • language:javascript: 按编程语言搜索
  • repo:owner/name: 在特定仓库中搜索
  • path:app/src: 在特定路径中搜索
  • extension:js: 按文件扩展名搜索
  • 示例: q: "import express" language:typescript path:src/

议题搜索

  • is:issue 或 is:pr: 按类型筛选
  • is:open 或 is:closed: 按状态筛选
  • label:bug: 按标签搜索
  • author:username: 按作者搜索
  • 示例: q: "memory leak" is:issue is:open label:bug

用户搜索

  • type:user 或 type:org: 按帐户类型筛选
  • followers:>1000: 按关注者筛选
  • location:London: 按位置搜索
  • 示例: q: "fullstack developer" location:London followers:>100

有关详细的搜索语法，请参阅 GitHub 的搜索文档。

设置

个人访问令牌

创建一个具有适当权限的 GitHub 个人访问令牌：

  • 转到 个人访问令牌（在 GitHub 设置 > 开发者设置中）
  • 选择您希望此令牌访问的仓库（公共、全部或选择）
  • 创建一个具有 repo 范围（“完全控制私有仓库”）的令牌
    • 或者，如果仅使用公共仓库，则仅选择 public_repo 范围
  • 复制生成的令牌

与 Claude 桌面一起使用

要将其与 Claude 桌面一起使用，请将以下内容添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "/path/to/github-enterprise-mcp/dist/index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

构建

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

许可证

此 MCP 服务器在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目仓库中的 LICENSE 文件。

推荐服务器

Baidu Map

Baidu Map

百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

官方
精选
JavaScript
Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

通过模型上下文协议启用与 Audiense Insights 账户的交互，从而促进营销洞察和受众数据的提取和分析，包括人口统计信息、行为和影响者互动。

官方
精选
本地
TypeScript
VeyraX

VeyraX

一个单一的 MCP 工具，连接你所有喜爱的工具：Gmail、日历以及其他 40 多个工具。

官方
精选
本地
graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外，还可以将任何内容（从 Slack 到 Gmail 再到播客订阅源）导入到 Graphlit 项目中，然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Kagi MCP Server

Kagi MCP Server

一个 MCP 服务器，集成了 Kagi 搜索功能和 Claude AI，使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。

官方
精选
Python
e2b-mcp-server

e2b-mcp-server

使用 MCP 通过 e2b 运行代码。

官方
精选
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
Exa MCP Server

Exa MCP Server

模型上下文协议（MCP）服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。

官方
精选