跳至主要内容

为 GitHub Enterprise 配置 GitHub MCP 服务器

了解如何配置 GitHub 模型上下文协议(MCP)服务器,使其与 GitHub Enterprise Server 或具备数据驻留的 GitHub Enterprise Cloud 配合使用。

GitHub MCP 服务器可以配置为与 GitHub Enterprise Server 和具有数据驻留的 GitHub Enterprise Cloud 配合使用。配置步骤取决于您使用的是远程还是本地 MCP 服务器。

关于企业 MCP 服务器配置

GitHub MCP 服务器支持两种企业部署类型

重要提示

GitHub Enterprise Server 支持远程 MCP 服务器托管。如果您使用的是 GitHub Enterprise Server,必须使用为企业配置本地 MCP 服务器中描述的本地 MCP 服务器配置。请跳过下面的远程 MCP 服务器配置章节。

先决条件

  • GitHub Enterprise Server 实例或具有数据驻留的 GitHub Enterprise Cloud 帐号
  • 在编辑器中已配置的 GitHub MCP 服务器。请参阅设置 GitHub MCP 服务器

为具有数据驻留的 GitHub Enterprise Cloud 配置远程 MCP 服务器

注意

本节仅适用于具有数据驻留的 GitHub Enterprise Cloud。若您使用 GitHub Enterprise Server,请跳转至为企业配置本地 MCP 服务器

具有数据驻留的 GitHub Enterprise Cloud 可以使用远程 MCP 服务器。要进行配置,需要将 MCP 服务器 URL 更新为指向您的 GitHub Enterprise Cloud 实例。

例如,如果您的 GitHub Enterprise Cloud 实例是 https://octocorp.ghe.com,则 MCP 服务器 URL 为 https://copilot-api.octocorp.ghe.com/mcp

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P(Windows/Linux)或 Command+Shift+P(Mac)打开命令面板。

  2. 键入并选择 MCP: Open User Configuration

  3. 在设置文件中,找到 servers 部分。如果您已经配置了 GitHub MCP 服务器,则会看到一个 github 条目。

  4. url 字段更新为指向您的 GitHub Enterprise Cloud 实例。

    选项 A:使用 PAT 进行身份验证

    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:github_mcp_pat}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "github_mcp_pat",
          "description": "GitHub PAT",
          "password": true
        }
      ]
    }
    

    选项 B:使用 OAuth 进行身份验证

    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
        }
      }
    }
    

    SUBDOMAIN.ghe.com 替换为您的 GHE.com 子域名。

  5. 保存文件。

  6. 使用 OAuth 与具有数据驻留的 GitHub Enterprise Cloud 配合时,请将 VS Code 设置指向您的 GitHub Enterprise Cloud 实例。将以下内容添加到您的VS Code 用户设置中。

    {
      "github-enterprise.uri": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
    }
    
  7. 重新启动 Visual Studio Code 或重新加载窗口,以使更改生效。

具有数据驻留的 GitHub Enterprise Cloud 可以使用远程 MCP 服务器。要进行配置,需要将 MCP 服务器 URL 更新为指向您的 GitHub Enterprise Cloud 实例。

例如,如果您的 GitHub Enterprise Cloud 实例是 https://octocorp.ghe.com,则 MCP 服务器 URL 为 https://copilot-api.octocorp.ghe.com/mcp

  1. 在 Visual Studio 菜单栏中,点击 View (视图),然后点击 GitHub Copilot Chat
  2. 在聊天面板底部,从模式下拉列表中选择 Agent
  3. 在 Copilot 聊天窗口中,点击工具图标,然后在工具选择器窗口中点击加号图标。
  4. 在 “Configure MCP server” 弹出窗口中,填写各字段。
    1. 对于 “Server ID”,输入 github
    2. 对于 “Type”,从下拉列表中选择 “HTTP/SSE”。
    3. 对于 “URL”,输入 https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp,将 YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。
    4. 在 “Headers” 下新增一个名为 “Authorization” 的请求头,值设为 Bearer YOUR_GITHUB_PAT,将 “YOUR_GITHUB_PAT” 替换为您的个人访问令牌。
  5. 点击保存

具有数据驻留的 GitHub Enterprise Cloud 可以使用远程 MCP 服务器。要进行配置,需要将 MCP 服务器 URL 更新为指向您的 GitHub Enterprise Cloud 实例。

例如,如果您的 GitHub Enterprise Cloud 实例是 https://octocorp.ghe.com,则 MCP 服务器 URL 为 https://copilot-api.octocorp.ghe.com/mcp

  1. 在右下角,单击

  2. 在菜单中选择 “Open Chat”,确保已切换到 Agent 模式,然后点击聊天窗口底部的工具图标(名为 “Configure your MCP server”)。

  3. 点击 Add MCP Tools

  4. mcp.json 文件中,添加以下配置,并将 YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名,将 YOUR_GITHUB_PAT 替换为您的个人访问令牌。

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    

具有数据驻留的 GitHub Enterprise Cloud 可以使用远程 MCP 服务器。要进行配置,需要将 MCP 服务器 URL 更新为指向您的 GitHub Enterprise Cloud 实例。

例如,如果您的 GitHub Enterprise Cloud 实例是 https://octocorp.ghe.com,则 MCP 服务器 URL 为 https://copilot-api.octocorp.ghe.com/mcp

  1. 打开 GitHub Copilot for Xcode 扩展并前往 “Settings”。

    • 或者,在已打开的 Xcode 工作区中,点击菜单栏的 Editor,选择 GitHub Copilot,然后点击 Open GitHub Copilot for Xcode Settings
  2. 选择 MCP 选项卡,再点击 Edit Config

  3. 添加以下配置,将 YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名,将 YOUR_GITHUB_PAT 替换为您的个人访问令牌。

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    

具有数据驻留的 GitHub Enterprise Cloud 可以使用远程 MCP 服务器。要进行配置,需要将 MCP 服务器 URL 更新为指向您的 GitHub Enterprise Cloud 实例。

例如,如果您的 GitHub Enterprise Cloud 实例是 https://octocorp.ghe.com,则 MCP 服务器 URL 为 https://copilot-api.octocorp.ghe.com/mcp

  1. 点击 Copilot 图标 () 在 Eclipse 底部状态栏中。

  2. 在菜单中选择 Open Chat,在聊天窗口中点击 “Configure Tools...” 图标。

    • 或者,您可以选择 Edit preferences,在左侧面板展开 GitHub Copilot 并点击 MCP
  3. 在 “Server Configurations” 下添加以下配置,将 YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名,将 YOUR_GITHUB_PAT 替换为您的个人访问令牌。

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
  4. 点击应用

为企业配置本地 MCP 服务器

GitHub Enterprise Server 和具有数据驻留的 GitHub Enterprise Cloud 都支持本地 MCP 服务器。您可以使用 GITHUB_HOST 环境变量或 --gh-host 命令行标志来配置本地服务器。

重要注意事项

  • 针对 GitHub Enterprise Server:请在主机名前加上 https:// URI 前缀,否则默认使用 http://,而 GitHub Enterprise Server 并不支持。
  • 针对具有数据驻留的 GitHub Enterprise Cloud:使用 https://YOURSUBDOMAIN.ghe.com 作为主机名。

使用 Docker 的配置

在 Visual Studio Code 中使用 Docker 配置本地 MCP 服务器

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P(Windows/Linux)或 Command+Shift+P(Mac)打开命令面板。

  2. 键入并选择 MCP: Open User Configuration

  3. 在设置文件中找到 servers 部分,若不存在则创建。

  4. 添加以下配置

    针对 GitHub Enterprise Server

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    YOUR_GHES_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)。

    针对具有数据驻留的 GitHub Enterprise Cloud

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。

  5. 保存文件。

  6. 重新启动 Visual Studio Code 或重新加载窗口,以使更改生效。

在 Visual Studio 中使用 Docker 配置本地 MCP 服务器时,需要手动编辑 mcp.json 文件。

  1. 在 Visual Studio 中打开 mcp.json 文件。该文件通常位于用户配置文件目录下。

  2. 添加以下配置

    针对 GitHub Enterprise Server

    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
            }
          }
        }
      }
    }
    

    YOUR_GHES_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)。

    针对具有数据驻留的 GitHub Enterprise Cloud

    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
            }
          }
        }
      }
    }
    

    YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。

  3. 保存文件。

在 JetBrains IDE 中使用 Docker 配置本地 MCP 服务器

  1. 在右下角,单击

  2. 在菜单中选择 “Open Chat”,确保已切换到 Agent 模式,然后点击聊天窗口底部的工具图标(名为 “Configure your MCP server”)。

  3. 点击 Add MCP Tools

  4. 添加以下配置

    针对 GitHub Enterprise Server

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    YOUR_GHES_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)。

    针对具有数据驻留的 GitHub Enterprise Cloud

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。

在 Xcode 中使用 Docker 配置本地 MCP 服务器

  1. 打开 GitHub Copilot for Xcode 扩展并前往 “Settings”。

    • 或者,在已打开的 Xcode 工作区中,点击菜单栏的 Editor,选择 GitHub Copilot,然后点击 Open GitHub Copilot for Xcode Settings
  2. 选择 MCP 选项卡,再点击 Edit Config

  3. 添加以下配置

    针对 GitHub Enterprise Server

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    YOUR_GHES_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)。

    针对具有数据驻留的 GitHub Enterprise Cloud

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。

在 Eclipse 中使用 Docker 配置本地 MCP 服务器

  1. 点击 Copilot 图标 () 在 Eclipse 底部状态栏中。

  2. 在菜单中选择 Open Chat,在聊天窗口中点击 “Configure Tools...” 图标。

    • 或者,您可以选择 Edit preferences,在左侧面板展开 GitHub Copilot 并点击 MCP
  3. 在 “Server Configurations” 下添加以下配置

    针对 GitHub Enterprise Server

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    YOUR_GHES_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)。

    针对具有数据驻留的 GitHub Enterprise Cloud

    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    YOURSUBDOMAIN 替换为您的 GitHub Enterprise Cloud 子域名。

  4. 点击应用

从源码构建时的配置

如果您从源码构建 MCP 服务器而非使用 Docker,可以设置 GITHUB_HOST 环境变量或使用 --gh-host 命令行标志。

使用环境变量

export GITHUB_HOST="https://YOUR_GHES_OR_GHEC_HOSTNAME"
./github-mcp-server stdio

使用命令行标志

./github-mcp-server --gh-host \
  "https://YOUR_GHES_OR_GHEC_HOSTNAME" stdio

YOUR_GHES_OR_GHEC_HOSTNAME 替换为您的 GitHub Enterprise Server 主机名(例如 https://github.example.com)或 GitHub Enterprise Cloud 主机名(例如 https://octocorp.ghe.com)。

后续步骤

© . This site is unofficial and not affiliated with GitHub, Inc.