企业项目管理、ORK、研发管理与敏捷开发工具平台

网站首页 > 精选文章 正文

GitHub 发布了官方的MCP 服务器(mine github)

wudianyun 2025-04-30 20:16:52 精选文章 13 ℃

GitHub MCP Server 是一个模型上下文协议 (MCP) 服务器,可与 GitHub API 无缝集成,为开发人员和工具提供高级自动化和交互功能。


使用案例

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

先决条件

  1. 要在容器中运行服务器,您需要安装Docker
  2. 创建 GitHub 个人访问令牌。MCP 服务器可以使用许多 GitHub API,因此请启用您认为合适的权限以授予您的 AI 工具(要了解有关访问令牌的更多信息,请查看文档)。

安装

与 VS Code 一起使用

为了快速安装,请使用本自述文件顶部的一键安装按钮之一。

对于手动安装,请将以下 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}"
        }
      }
    }
  }
}

有关使用 MCP 服务器工具的更多信息,请参阅 VS Code 的代理模式文档

与 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": "<YOUR_TOKEN>"
      }
    }
  }
}

从源代码构建

如果您没有 Docker,您可以使用go它在目录中构建二进制文件 cmd/github-mcp-server,并使用github-mcp-server stdio 将环境变量设置为您的令牌的命令
GITHUB_PERSONAL_ACCESS_TOKEN

GitHub 企业服务器

该标志--gh-host和环境变量GH_HOST可用于设置 GitHub Enterprise Server 主机名。

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"
最近发表
标签列表