Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions entries/github-mcp/catalog-metadata.v1.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down Expand Up @@ -81,6 +85,6 @@
"issue_manage",
"code_search"
],
"toolCount": 51
"toolCount": 93
}
}
20 changes: 16 additions & 4 deletions entries/github-mcp/install.md
Original file line number Diff line number Diff line change
@@ -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=<your-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
```
4 changes: 2 additions & 2 deletions entries/github-mcp/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": [
Expand All @@ -22,7 +22,7 @@
"issue_manage",
"code_search"
],
"toolCount": 51,
"toolCount": 93,
"install": {
"method": "docker",
"packageName": "ghcr.io/github/github-mcp-server",
Expand Down
21 changes: 16 additions & 5 deletions entries/github-mcp/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
```
Expand All @@ -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` 支持游标分页。
Loading