name: github-mcp description: GitHub API 操作 - 仓库、问题、拉取请求、工作流、代码安全、讨论、代码片段等。用于 GitHub 相关任务,如管理 PR、问题、搜索代码和监控工作流。 version: 1.0.0 model: sonnet invoked_by: both user_invocable: true tools: [Read, Write, Bash] best_practices:
- 使用 gh CLI 进行大多数操作
- 在操作前验证身份验证
- 批量操作时检查速率限制 error_handling: graceful streaming: supported verified: false lastVerifiedAt: 2026-02-19T05:29:09.098Z
模式:认知/提示驱动 — 没有独立的实用脚本;通过代理上下文使用。
GitHub 技能
概述
此技能提供对官方 GitHub MCP 服务器的访问,具有逐步披露功能,以优化上下文使用。
上下文节省:约 95% 的减少
- MCP 模式:约 50,000 个令牌始终加载(80+ 工具)
- 技能模式:约 500 个令牌元数据 + 按需加载
要求
- Docker 已安装并运行
- 设置
GITHUB_PERSONAL_ACCESS_TOKEN环境变量
工具集
服务器提供 80+ 个工具,涵盖 19 个工具集:
| 工具集 | 描述 |
|---|---|
actions |
工作流管理、运行、任务、工件 |
code_security |
扫描警报、代码分析 |
discussions |
论坛互动 |
gists |
代码片段管理 |
issues |
问题创建、更新、评论 |
labels |
标签管理和过滤 |
projects |
GitHub Projects 看板管理 |
pull_requests |
PR 创建、审查、合并 |
repos |
代码搜索、提交、发布、分支 |
users |
用户搜索和管理 |
orgs |
组织和团队管理 |
notifications |
通知管理 |
secret_scanning |
秘密扫描警报 |
context |
关于用户的上下文 |
快速参考
使用 gh CLI 进行 GitHub 操作:
# 获取仓库信息
gh repo view anthropics/claude-code
# 列出问题
gh issue list --repo anthropics/claude-code
# 搜索代码
gh search code "language:python MCP"
# 创建问题
gh issue create --repo me/myrepo --title "Bug" --body "Description"
# 列出拉取请求
gh pr list --repo anthropics/claude-code
常用工具(默认工具集:40 个工具)
仓库操作
search_repositories- 搜索仓库create_repository- 创建新仓库fork_repository- 分叉仓库list_commits- 列出仓库提交get_commit- 获取提交详情get_file_contents- 从仓库获取文件内容create_or_update_file- 创建或更新文件delete_file- 删除文件push_files- 推送多个文件search_code- 在 GitHub 上搜索代码list_branches- 列出仓库分支create_branch- 创建新分支list_tags- 列出仓库标签get_tag- 获取标签详情list_releases- 列出发布get_latest_release- 获取最新发布get_release_by_tag- 按标签获取发布
问题操作
list_issues- 列出仓库问题issue_read- 读取问题详情issue_write- 创建/更新问题add_issue_comment- 向问题添加评论search_issues- 搜索问题list_issue_types- 列出问题类型(用于组织)get_label- 获取标签详情sub_issue_write- 管理子问题assign_copilot_to_issue- 分配 Copilot 到问题
拉取请求操作
list_pull_requests- 列出仓库拉取请求pull_request_read- 读取 PR 详情create_pull_request- 创建新 PRupdate_pull_request- 更新 PRupdate_pull_request_branch- 更新 PR 分支merge_pull_request- 合并 PRsearch_pull_requests- 搜索拉取请求pull_request_review_write- 创建/提交 PR 审查add_comment_to_pending_review- 向待审查添加评论request_copilot_review- 请求 Copilot 审查
用户与团队操作
get_me- 获取当前认证用户search_users- 搜索用户get_teams- 获取组织团队get_team_members- 获取团队成员
配置
该技能使用 Docker 运行官方 GitHub MCP 服务器:
- 镜像:
ghcr.io/github/github-mcp-server - 认证:
GITHUB_PERSONAL_ACCESS_TOKEN环境变量
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
GITHUB_PERSONAL_ACCESS_TOKEN |
是 | GitHub PAT 用于身份验证 |
GITHUB_HOST |
否 | 用于 GitHub Enterprise(默认:github.com) |
GITHUB_TOOLSETS |
否 | 以逗号分隔的工具集以启用 |
GITHUB_READ_ONLY |
否 | 设置为 1 进入只读模式 |
限制工具集
使用 MCP 时,通过环境变量配置工具集:
# 仅仓库和问题
GITHUB_TOOLSETS=repos,issues
# 仅拉取请求和代码安全
GITHUB_TOOLSETS=pull_requests,code_security
错误处理
如果操作失败:
- 验证 Docker 是否运行:
docker ps - 检查 GitHub 令牌是否设置:
echo $GITHUB_PERSONAL_ACCESS_TOKEN - 确保令牌具有操作所需的权限
- 使用
gh auth status验证身份验证
相关
- 官方 GitHub MCP 服务器:https://github.com/github/github-mcp-server
- GitHub API 文档:https://docs.github.com/en/rest
记忆协议(强制)
开始前:
阅读 .claude/context/memory/learnings.md
完成后:
- 新模式 ->
.claude/context/memory/learnings.md - 发现问题 ->
.claude/context/memory/issues.md - 做出决策 ->
.claude/context/memory/decisions.md
假设中断:如果不在记忆中,则未发生。