快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

GitHub MCP服务器

GitHub MCP服务器是一个模型上下文协议（MCP）服务器，提供与GitHub API的无缝集成，实现高级开发人员和工具的自动化和交互能力。

](https://insiders.vscode.dev/redirect/mcp/install?name=github&inputs=%5B%7B%22id%22%3A%22github_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22GitHub%20Personal%20Access%20Token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22GITHUB_PERSONAL_ACCESS_TOKEN%22%2C%22ghcr.io%2Fgithub%2Fgithub-mcp-server%22%5D%2C%22env%22%3A%7B%22GITHUB_PERSONAL_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agithub_token%7D%22%7D%7D) ](https://insiders.vscode.dev/redirect/mcp/install?name=github&inputs=%5B%7B%22id%22%3A%22github_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22GitHub%20Personal%20Access%20Token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22GITHUB_PERSONAL_ACCESS_TOKEN%22%2C%22ghcr.io%2Fgithub%2Fgithub-mcp-server%22%5D%2C%22env%22%3A%7B%22GITHUB_PERSONAL_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agithub_token%7D%22%7D%7D&quality=insiders)

用例

自动化GitHub工作流和流程。
从GitHub存储库中提取和分析数据。
构建与GitHub生态系统交互的AI驱动工具和应用程序。

先决条件

要在容器中运行服务器，您需要码头工人安装。
.

MCP服务器可以使用许多GitHub API，因此请启用您认为授予AI工具的权限（要了解有关访问令牌的更多信息，请查看文档).

安装

使用VS代码

为了快速安装，请使用此README顶部的一键安装按钮之一。

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 中不需要密钥 .vscode/mcp.json 文件。

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

更多关于在VS Code中使用MCP服务器工具的信息代理模式文档.

使用Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
      }
    }
  }
}

从源代码构建

如果你没有Docker，你可以使用 go 在 cmd/github-mcp-server 目录，并使用 github-mcp-server stdio 命令与 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量设置为你的令牌。

GitHub企业服务器

国旗 --gh-host 以及环境变量 GH_HOST 可用于设置 GitHub企业服务器主机名。

i18n/覆盖性描述

通过创建 github-mcp-server-config.json 文件与二进制文件位于同一目录中。

该文件应包含一个JSON对象，其中工具名称作为键，新描述为值。例如：

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "an alternative description",
  "TOOL_CREATE_BRANCH_DESCRIPTION": "Create a new branch in a GitHub repository"
}

您可以通过运行二进制文件来创建当前翻译的导出这 --export-translations 旗帜。

此标志将保留您在添加时所做的任何翻译/覆盖自上次您使用二进制文件以来添加到二进制文件中的任何新翻译出口。

./github-mcp-server --export-translations
cat github-mcp-server-config.json

您还可以使用ENV变量来覆盖描述。环境变量名与JSON文件中的键相同，前缀为 GITHUB_MCP_ 全部大写。

例如，要覆盖 TOOL_ADD_ISSUE_COMMENT_DESCRIPTION 工具，你可以设置以下环境变量：

export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="an alternative description"

工具

用户

get_me -获取已验证用户的详细信息

- 无需参数

问题

获取问题 -获取存储库中问题的内容

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - issue_number：问题编号（编号，必填）

获取问题注释 -获取GitHub问题的评论

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - issue_number：问题编号（编号，必填）

创建_发行 -在GitHub存储库中创建新问题

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - title：发行标题（字符串，必填） - body：发布正文内容（字符串，可选） - assignees：要分配给此问题的用户名（string\[\]，可选） - labels：应用于此问题的标签（string\[\]，可选）

add_issue_comment -向问题添加评论

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - issue_number：问题编号（编号，必填） - body：注释文本（字符串，必填）

list_issues -列出和筛选存储库问题

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - state：按状态筛选（“打开”、“关闭”、“全部”）（字符串，可选） - labels：要筛选的标签（string\[\]，可选） - sort：排序方式（“已创建”、“已更新”、“注释”）（字符串，可选） - direction：排序方向（'sc'，'sec'）（字符串，可选） - since：按日期筛选（ISO 8601时间戳）（字符串，可选） - page：页码（数字，可选） - perPage：每页结果（数量，可选）

update_issue -更新GitHub存储库中的现有问题

- owner：存储库所有者（字符串，必填） - repo：存储库名称（字符串，必填） - issue_number：要更新的问题编号（编号，必填） - title：新标题（字符串，可选） - body：新描述（字符串，可选） - state：新状态（“打开”或“关闭”）（字符串，可选） - labels：新标签（string\[\]，可选） - assignees：新受让人（string\[\]，可选） - milestone：新里程碑编号（编号，可选）

搜索问题 -搜索问题并提取请求

- query：搜索查询（字符串，必填） - sort：排序字段（字符串，可选） - order：排序顺序（字符串，可选） - page：页码（数字，可选） - perPage：每页结果（数量，可选）