From 0024416b10f76feaa9f7d6e3ad4aa2ebd55598ce Mon Sep 17 00:00:00 2001 From: yi-ge Date: Tue, 3 Nov 2026 02:26:22 +0000 Subject: [PATCH 1/2] =?UTF-8?q?chore(registry):=20=E6=9B=B4=E6=96=B0=20git?= =?UTF-8?q?hub-mcp=20=E5=80=99=E9=80=89=202.0.3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- entries/github-mcp/upstream-update-candidate.json | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 entries/github-mcp/upstream-update-candidate.json diff --git a/entries/github-mcp/upstream-update-candidate.json b/entries/github-mcp/upstream-update-candidate.json new file mode 100644 index 0000000..7c3ffaf --- /dev/null +++ b/entries/github-mcp/upstream-update-candidate.json @@ -0,0 +1,11 @@ +{ + "schemaVersion": 1, + "entryId": "github-mcp", + "listedVersion": "0.32.0", + "observedVersion": "2.0.3", + "metadataUrl": "https://api.github.com/repos/github/github-mcp-server/releases/latest", + "reason": "容器或二进制新版需要固定制品 digest 和许可准入证据；不自动拉取或运行", + "reviewPassed": false, + "findings": {}, + "note": "仅候选说明，不修改当前 manifest、sidecar、审核结论或安装状态。" +} From 36ecec3d48f10fb22d0c557b315f04c623c0d3bc Mon Sep 17 00:00:00 2001 From: yi-ge Date: Wed, 4 Nov 2026 11:49:13 +0800 Subject: [PATCH 2/2] =?UTF-8?q?chore(registry):=20=E5=8D=87=E7=BA=A7=20git?= =?UTF-8?q?hub-mcp=20=E8=87=B3=202.0.3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 同步版本、发布时间与核对时间 - toolCount 按 2.0.3 README 中本地服务的全部工具更新为 93，说明默认工具集只启用 45 个 - install.md 与 usage.md 改为与 manifest 一致的 Docker 启动方式，替换已弃用的 npx 包说明 - 记录 2.0 的主要变化 - 移除已完成的候选说明文件 --- entries/github-mcp/catalog-metadata.v1.json | 14 ++++++++----- entries/github-mcp/install.md | 20 ++++++++++++++---- entries/github-mcp/manifest.json | 4 ++-- .../github-mcp/upstream-update-candidate.json | 11 ---------- entries/github-mcp/usage.md | 21 ++++++++++++++----- 5 files changed, 43 insertions(+), 27 deletions(-) delete mode 100644 entries/github-mcp/upstream-update-candidate.json diff --git a/entries/github-mcp/catalog-metadata.v1.json b/entries/github-mcp/catalog-metadata.v1.json index 934531b..7ad30a7 100644 --- a/entries/github-mcp/catalog-metadata.v1.json +++ b/entries/github-mcp/catalog-metadata.v1.json @@ -25,23 +25,27 @@ }, "release": { "state": "known", - "version": "0.32.0", + "version": "2.0.3", "versionScheme": "semver" }, "timestamps": { "catalogUpdatedAt": { "state": "known", - "value": "2026-03-09", + "value": "2026-11-04", "precision": "day" }, "releasePublishedAt": { - "state": "unknown" + "state": "known", + "value": "2026-10-21T09:52:29Z", + "precision": "second" }, "reviewedAt": { "state": "unknown" }, "upstreamObservedAt": { - "state": "unknown" + "state": "known", + "value": "2026-11-04", + "precision": "day" } }, "provenance": { @@ -81,6 +85,6 @@ "issue_manage", "code_search" ], - "toolCount": 51 + "toolCount": 93 } } diff --git a/entries/github-mcp/install.md b/entries/github-mcp/install.md index 228fe19..172839c 100644 --- a/entries/github-mcp/install.md +++ b/entries/github-mcp/install.md @@ -1,17 +1,29 @@ # 安装 GitHub MCP ## 环境要求 -- Node.js >= 18 +- Docker，且 Docker 服务正在运行 +- 能拉取公开镜像 `ghcr.io/github/github-mcp-server`（拉取报错时多半是本机 `ghcr.io` 登录凭据过期，执行 `docker logout ghcr.io` 后重试） +- GitHub Personal Access Token ## 安装步骤 -### 配置环境变量 +### 1. 准备访问令牌 +在 GitHub 创建 Personal Access Token，只授予实际需要的仓库和权限，然后在启动 MCP 的环境中提供： + ```bash export GITHUB_PERSONAL_ACCESS_TOKEN= ``` +连接配置用 `-e GITHUB_PERSONAL_ACCESS_TOKEN` 把这个变量传进容器，令牌不写入镜像或条目文件。 + +### 2. 拉取镜像 +```bash +docker pull ghcr.io/github/github-mcp-server +``` + +连接配置没有固定镜像标签，拉取的是上游最新发行版（目录核对时为 2.0.3）。需要固定版本时可改用 `ghcr.io/github/github-mcp-server:v2.0.3`。 + ## 验证 -运行以下命令确认可正常启动： ```bash -npx -y @modelcontextprotocol/server-github --help +docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server --help ``` diff --git a/entries/github-mcp/manifest.json b/entries/github-mcp/manifest.json index 22911ae..dcd0c32 100644 --- a/entries/github-mcp/manifest.json +++ b/entries/github-mcp/manifest.json @@ -2,7 +2,7 @@ "id": "github-mcp", "name": "GitHub MCP", "type": "mcp", - "version": "0.32.0", + "version": "2.0.3", "author": "GitHub", "description": "代码仓库操作，支持 PR、Issue、代码搜索和仓库管理", "tags": [ @@ -22,7 +22,7 @@ "issue_manage", "code_search" ], - "toolCount": 51, + "toolCount": 93, "install": { "method": "docker", "packageName": "ghcr.io/github/github-mcp-server", diff --git a/entries/github-mcp/upstream-update-candidate.json b/entries/github-mcp/upstream-update-candidate.json deleted file mode 100644 index 7c3ffaf..0000000 --- a/entries/github-mcp/upstream-update-candidate.json +++ /dev/null @@ -1,11 +0,0 @@ -{ - "schemaVersion": 1, - "entryId": "github-mcp", - "listedVersion": "0.32.0", - "observedVersion": "2.0.3", - "metadataUrl": "https://api.github.com/repos/github/github-mcp-server/releases/latest", - "reason": "容器或二进制新版需要固定制品 digest 和许可准入证据；不自动拉取或运行", - "reviewPassed": false, - "findings": {}, - "note": "仅候选说明，不修改当前 manifest、sidecar、审核结论或安装状态。" -} diff --git a/entries/github-mcp/usage.md b/entries/github-mcp/usage.md index 5899a44..9a74881 100644 --- a/entries/github-mcp/usage.md +++ b/entries/github-mcp/usage.md @@ -5,16 +5,20 @@ ## 连接方式 - **传输协议**：stdio -- **启动命令**：`npx -y @modelcontextprotocol/server-github` +- **启动命令**：`docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server` ### 连接配置 ```json { "transport": "stdio", - "command": "npx", + "command": "docker", "args": [ - "-y", - "@modelcontextprotocol/server-github" + "run", + "-i", + "--rm", + "-e", + "GITHUB_PERSONAL_ACCESS_TOKEN", + "ghcr.io/github/github-mcp-server" ] } ``` @@ -25,4 +29,11 @@ - `issue_manage` - `code_search` -共提供 **35** 个工具。 +2.0.3 的 README 为本地服务列出 **93** 个工具，按工具集分组。未指定工具集时只启用默认的 `context`、`repos`、`issues`、`pull_requests`、`users`，共 45 个；其余工具集需要在容器环境变量里设置 `GITHUB_TOOLSETS`，例如 `-e GITHUB_TOOLSETS="default,actions"`，设为 `all` 时全部启用。 + +只需要读取时可加 `-e GITHUB_READ_ONLY=1`，服务只提供只读工具，即使显式指定了写入工具也会跳过。 + +## 2.0 的变化 +- 新增结构化输出和输出 Schema，只向声明支持 MCP 2026-07-28 及以上规范的客户端提供；旧版客户端的工具调用方式不变。 +- Go 模块路径改为 v2，只影响把它当作 Go 库引用的项目，不影响容器使用。 +- 2.0.3 修复了仓库资源 URI 的 UTF-8 编码问题；`get_file_contents` 遇到超过 1 MB 的文件时改为返回资源链接；`list_label` 支持游标分页。