GitHub Issues

使用 @modelcontextprotocol/server-github 模型上下文协议服务器管理 GitHub Issues。

可用工具

模型上下文协议工具（读取操作）

命令行界面 / REST 应用程序编程接口（写入操作）

模型上下文协议服务器目前不支持创建、更新或评论 issue。请对这些操作使用 gh api。

注意： gh issue create 可用于基本的 issue 创建，但不支持 --type 标志。当你需要设置 issue 类型时，请使用 gh api。

工作流程

1. 确定操作：创建、更新还是查询？
2. 收集上下文：获取仓库信息、现有标签、里程碑（如需要）
3. 构建内容：使用 references/templates.md 中的适当模板
4. 执行：使用模型上下文协议工具进行读取，使用 gh api 进行写入
5. 确认：向用户报告 issue 的网址

创建 Issues

使用 gh api 创建 issue。这支持包括 issue 类型在内的所有参数。

gh api repos/{所有者}/{仓库}/issues \
  -X POST \
  -f title="Issue 标题" \
  -f body="Issue 正文（支持 Markdown）" \
  -f type="Bug" \
  --jq '{number, html_url}'

可选参数

在 gh api 调用中添加以下任一标志：

-f type="Bug"                    # Issue 类型（Bug、Feature、Task、Epic 等）
-f labels[]="bug"                # 标签（可重复多次）
-f assignees[]="username"        # 负责人（可重复多次）
-f milestone=1                   # 里程碑编号

Issue 类型 是组织级别的元数据。要发现可用的类型，请使用：

gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'

优先使用 Issue 类型而非标签进行分类。 当 Issue 类型可用时（例如，Bug、Feature、Task），请使用 type 参数，而不是应用等效的标签（如 bug 或 enhancement）。Issue 类型是 GitHub 上对 issue 进行分类的规范方式。仅在组织未配置任何 Issue 类型时，才退而使用标签。

标题指南

• 具体且可操作
• 保持在 72 个字符以内
• 当设置了 Issue 类型时，不要添加冗余前缀，如 [Bug]
• 示例：
  • 启用单点登录时登录失败 (type=Bug)
  • 添加深色模式支持 (type=Feature)
  • 为认证模块添加单元测试 (type=Task)

正文结构

始终使用 references/templates.md 中的模板。根据 Issue 类型选择：

更新 Issues

使用 gh api 结合 PATCH 方法：

gh api repos/{所有者}/{仓库}/issues/{编号} \
  -X PATCH \
  -f state=closed \
  -f title="更新后的标题" \
  --jq '{number, html_url}'

只包含你想要更改的字段。可用字段：title、body、state (open/closed)、labels、assignees、milestone。

示例

示例 1：错误报告

用户：”创建一个 bug issue – 使用单点登录时登录页面崩溃”

操作：

gh api repos/github/awesome-copilot/issues \
  -X POST \
  -f title="使用单点登录时登录页面崩溃" \
  -f type="Bug" \
  -f body="## 描述
当用户尝试使用单点登录进行身份验证时，登录页面崩溃。

## 重现步骤
1. 导航到登录页面
2. 点击'使用单点登录登录'
3. 页面崩溃

## 预期行为
单点登录身份验证应完成并重定向到仪表板。

## 实际行为
页面无响应并显示错误。" \
  --jq '{number, html_url}'

示例 2：功能请求

用户：”创建一个高优先级的深色模式功能请求”

操作：

gh api repos/github/awesome-copilot/issues \
  -X POST \
  -f title="添加深色模式支持" \
  -f type="Feature" \
  -f labels[]="high-priority" \
  -f body="## 摘要
添加深色模式主题选项，以改善用户体验和可访问性。

## 动机
- 减少在低光环境下的眼睛疲劳
- 用户日益期望此功能

## 提议的解决方案
实现带有系统偏好检测的主题切换开关。

## 验收标准
- [ ] 设置中的切换开关
- [ ] 持久化用户偏好
- [ ] 默认遵循系统偏好" \
  --jq '{number, html_url}'

常用标签

在适用时使用这些标准标签：

提示

• 在创建 issue 之前，务必确认仓库上下文
• 询问缺失的关键信息，而不是猜测
• 当知道关联关系时，链接相关 issue：与 #123 相关
• 对于更新操作，先获取当前 issue 以保留未更改的字段

扩展能力

以下功能需要超越基础模型上下文协议工具的 REST 或 GraphQL 应用程序编程接口。每个功能都在其自己的参考文件中记录，以便代理只加载所需的知识。