mcpField
G
github-mcp

github-mcp

github.com/oimiragieo开发4481 次安装17 周前更新
代码仓库

关于 github-mcp

github-mcp 是一项 Agent 技能，按需加载官方 GitHub MCP 服务的能力，避免始终将完整工具集放入上下文。它面向 GitHub 操作，需要 Docker 和 GitHub 个人访问令牌。

主要功能

  1. 01按需使用 GitHub 工具
  2. 02仓库、Issue 和 PR 操作
  3. 0319 种可配置工具集
  4. 04可选只读模式

适用场景

  1. 01搜索仓库和代码
  2. 02创建或更新 Issue 与 PR
  3. 03管理工作流和安全警报

MCP 相关

通过 Docker 运行官方 GitHub MCP 服务，供 Agent 使用。可用环境变量选择工具集，并通过 GITHUB_PERSONAL_ACCESS_TOKEN 进行身份验证。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/oimiragieo/agent-studio --skill github-mcp

安装后在 Claude Code 中输入/github-mcp确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

commands/
github-mcp.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
github-mcp.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

详细介绍

模式：认知/提示词驱动 — 没有独立的实用脚本；通过 Agent 上下文使用。

GitHub 技能

概述

此技能可访问官方 GitHub MCP 服务，并通过渐进式披露优化上下文使用。

节省的上下文：约减少 95%

  • MCP 模式：始终加载约 50,000 个 token（80 多个工具）
  • 技能模式：约 500 个 token 的元数据 + 按需加载

要求

  • 已安装并运行 Docker
  • 已设置 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量

工具集

该服务提供 19 个工具集中的 80 多个工具：

工具集说明
actions工作流管理、运行记录、作业、构件
code_security扫描警报、代码分析
discussions论坛互动
gists代码片段管理
issues创建、更新和评论 Issue
labels标签管理与筛选
projectsGitHub Projects 看板管理
pull_requests创建、审查和合并 PR
repos代码搜索、提交、发布版本、分支
users用户搜索与管理
orgs组织与团队管理
notifications通知管理
secret_scanning密钥扫描警报
context用户相关上下文

快速参考

使用 gh CLI 执行 GitHub 操作：

# Get repository info
gh repo view anthropics/claude-code

# List issues
gh issue list --repo anthropics/claude-code

# Search code
gh search code "language:python MCP"

# Create issue
gh issue create --repo me/myrepo --title "Bug" --body "Description"

# List pull requests
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 - 按标签获取发布版本
Issue 操作
  • list_issues - 列出仓库 Issue
  • issue_read - 读取 Issue 详情
  • issue_write - 创建/更新 Issue
  • add_issue_comment - 为 Issue 添加评论
  • search_issues - 搜索 Issue
  • list_issue_types - 列出 Issue 类型（适用于组织）
  • get_label - 获取标签详情
  • sub_issue_write - 管理子 Issue
  • assign_copilot_to_issue - 将 Copilot 指派给 Issue
拉取请求操作
  • list_pull_requests - 列出仓库拉取请求
  • pull_request_read - 读取 PR 详情
  • create_pull_request - 创建新 PR
  • update_pull_request - 更新 PR
  • update_pull_request_branch - 更新 PR 分支
  • merge_pull_request - 合并 PR
  • search_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 时，通过环境变量配置工具集：

# Only repos and issues
GITHUB_TOOLSETS=repos,issues

# Only pull requests and code security
GITHUB_TOOLSETS=pull_requests,code_security

错误处理

如果操作失败：

  1. 确认 Docker 正在运行：docker ps
  2. 检查是否已设置 GitHub 令牌：echo $GITHUB_PERSONAL_ACCESS_TOKEN
  3. 确保令牌具有执行该操作所需的权限
  4. 使用 gh auth status 验证身份验证状态

相关内容

记忆协议（强制）

开始之前： 阅读 .claude/context/memory/learnings.md

完成之后：

  • 新模式 -> .claude/context/memory/learnings.md
  • 发现问题 -> .claude/context/memory/issues.md
  • 做出决策 -> .claude/context/memory/decisions.md

假设任务可能中断：如果没有记录在记忆中，就视为从未发生。

评论

支持 Markdown