GitHub

环境变量（推荐）

要确保 GitHub PAT 安全，并能在不同的 MCP 宿主之间重复使用：

1. 将 PAT 存储在环境变量中

   export GITHUB_PAT=your_token_here
   

   或创建 .env 文件：

   GITHUB_PAT=your_token_here
   

2. 保护 .env 文件

   # Add to .gitignore to prevent accidental commits
   echo ".env" >> .gitignore
   

3. 在配置中引用令牌

   # CLI usage
   claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/aifity/omnigit-mcp
   
   # In config files (where supported)
   "env": {
     "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_PAT"
   }
   

注意：宿主应用和 IDE 对环境变量的支持各不相同。一些应用（如 Windsurf）要求在配置文件中硬编码令牌。

令牌安全最佳实践

• 最小权限范围：仅授予必要的权限

  • repo - 仓库操作
  • read:packages - Docker 镜像访问
  • read:org - 组织团队访问

• 使用独立令牌：为不同项目／环境使用不同的 PAT

• 定期轮换：定期更新令牌

• 切勿提交：不要将令牌提交到版本控制中

• 文件权限：限制对包含令牌的配置文件的访问

  chmod 600 ~/.your-app/config.json
  

{
  "inputs": [
    {
      "type": "promptString",
      "id": "github_token",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ],
  "servers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/aifity/omnigit-mcp"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  }
}

Actions

• actions_get - 获取 GitHub Actions 资源（工作流、工作流运行、作业和构件）的详细信息

  • Required OAuth Scopes：repo
  • method：要执行的方法（字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）
  • resource_id：资源的唯一标识符。其值因提供的“method”而异，因此请确保提供正确的 ID：
    • 对于 'get_workflow' 方法，请提供工作流 ID 或工作流文件名（例如 ci.yaml）。
    • 对于 'get_workflow_run'、'get_workflow_run_usage' 和 'get_workflow_run_logs_url' 方法，请提供工作流运行 ID。
    • 对于 'download_workflow_run_artifact' 方法，请提供构件 ID。
    • 对于 'get_workflow_job' 方法，请提供作业 ID。 （字符串，必填）

• actions_list - 列出仓库中的 GitHub Actions 工作流

  • Required OAuth Scopes：repo
  • method：要执行的操作（字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（默认值：1）（数字，可选）
  • per_page：每页结果数（默认值：30，最大值：100）（数字，可选）
  • repo：仓库名称（字符串，必填）
  • resource_id：资源的唯一标识符。其值因提供的“method”而异，因此请确保提供正确的 ID：
    • 对于 'list_workflows' 方法，无需提供资源 ID。
    • 对于 'list_workflow_runs' 方法，请提供工作流 ID 或工作流文件名（例如 ci.yaml）；也可以省略，以列出仓库中的所有工作流运行。
    • 对于 'list_workflow_jobs' 和 'list_workflow_run_artifacts' 方法，请提供工作流运行 ID。 （字符串，可选）
  • workflow_jobs_filter：工作流作业的筛选条件。ONLY 用于 method 为 'list_workflow_jobs' 时（对象，可选）
  • workflow_runs_filter：工作流运行的筛选条件。ONLY 用于 method 为 'list_workflow_runs' 时（对象，可选）

• actions_run_trigger - 触发 GitHub Actions 工作流操作

  • Required OAuth Scopes：repo
  • inputs：工作流接受的输入。仅用于 'run_workflow' 方法。（对象，可选）
  • method：要执行的方法（字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • ref：工作流的 Git 引用。可以是分支或标签名称。'run_workflow' 方法必填。（字符串，可选）
  • repo：仓库名称（字符串，必填）
  • run_id：工作流运行的 ID。除 'run_workflow' 外的所有方法均必填。（数字，可选）
  • workflow_id：工作流 ID（数字）或工作流文件名（例如 main.yml、ci.yaml）。'run_workflow' 方法必填。（字符串，可选）

• get_job_logs - 获取 GitHub Actions 工作流作业日志

  • 所需 OAuth 权限范围：repo
  • failed_only：为 true 时，获取指定 run_id 的工作流运行中所有失败作业的日志。需要提供 run_id。（boolean，可选）
  • job_id：工作流作业的唯一标识符。获取单个作业的日志时必填。（number，可选）
  • owner：仓库所有者（string，必填）
  • repo：仓库名称（string，必填）
  • return_content：返回实际日志内容而非 URL（boolean，可选）
  • run_id：工作流运行的唯一标识符。failed_only 为 true 时，获取该运行中所有失败作业的日志需要此参数。（number，可选）
  • tail_lines：从日志末尾返回的行数（number，可选）

代码质量

• get_code_quality_finding - 获取代码质量问题
  • 所需 OAuth 权限范围：repo
  • findingNumber：问题编号。（number，必填）
  • owner：仓库所有者。（string，必填）
  • repo：仓库名称。（string，必填）

代码安全

• get_code_scanning_alert - 获取代码扫描警报

  • 所需 OAuth 权限范围：security_events
  • 接受的 OAuth 权限范围：repo、security_events
  • alertNumber：警报编号。（number，必填）
  • owner：仓库所有者。（string，必填）
  • repo：仓库名称。（string，必填）

• list_code_scanning_alerts - 列出代码扫描警报

  • 所需 OAuth 权限范围：security_events
  • 接受的 OAuth 权限范围：repo、security_events
  • owner：仓库所有者。（string，必填）
  • page：分页页码（最小值为 1）（number，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（number，可选）
  • ref：要列出结果对应的 Git 引用。（string，可选）
  • repo：仓库名称。（string，必填）
  • severity：按严重程度筛选代码扫描警报（string，可选）
  • state：按状态筛选代码扫描警报。默认为 open（string，可选）
  • tool_name：用于代码扫描的工具名称。（string，可选）

上下文

• get_me - 获取我的用户资料

  • 无需参数

• get_team_members - 获取团队成员

  • 所需 OAuth 权限范围：read:org
  • 接受的 OAuth 权限范围：admin:org、read:org、write:org
  • org：包含该团队的组织登录名（所有者）。（string，必填）
  • team_slug：团队标识名（string，必填）

• get_teams - 获取团队

  • 所需 OAuth 权限范围：read:org
  • 接受的 OAuth 权限范围：admin:org、read:org、write:org
  • user：要获取团队的用户名。若未提供，则使用已认证用户。（string，可选）

Dependabot

• get_dependabot_alert - 获取 Dependabot 警报

  • Required OAuth Scopes：security_events
  • Accepted OAuth Scopes：repo、security_events
  • alertNumber：警报编号。（数字，必填）
  • owner：仓库所有者。（字符串，必填）
  • repo：仓库名称。（字符串，必填）

• list_dependabot_alerts - 列出 Dependabot 警报

  • Required OAuth Scopes：security_events
  • Accepted OAuth Scopes：repo、security_events
  • after：用于分页的游标。使用上一次响应中的游标。（字符串，可选）
  • owner：仓库所有者。（字符串，必填）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称。（字符串，必填）
  • severity：按严重程度筛选 Dependabot 警报（字符串，可选）
  • state：按状态筛选 Dependabot 警报。默认为 open（字符串，可选）

讨论

• get_discussion - 获取讨论

  • 所需 OAuth 范围：repo
  • discussionNumber：讨论编号（数字，必需）
  • owner：仓库所有者（字符串，必需）
  • repo：仓库名称（字符串，必需）

• get_discussion_comments - 获取讨论评论

  • 所需 OAuth 范围：repo
  • after：用于分页的游标。使用上一条响应中的游标。（字符串，可选）
  • discussionNumber：讨论编号（数字，必需）
  • includeReplies：为 true 时，每条顶级评论都会包含嵌套在其中的回复（每条评论最多 100 条回复，这是 GitHub API 的上限）。默认值为 false。（布尔值，可选）
  • owner：仓库所有者（字符串，必需）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必需）

• list_discussion_categories - 列出讨论类别

  • 所需 OAuth 范围：repo
  • owner：仓库所有者（字符串，必需）
  • repo：仓库名称。如果未提供，则会在组织级别查询讨论类别。（字符串，可选）

• list_discussions - 列出讨论

  • 所需 OAuth 范围：repo
  • after：用于分页的游标。使用上一条响应中的游标。（字符串，可选）
  • category：按讨论类别 ID 筛选（可选）。如果提供，则仅列出属于该类别的讨论。（字符串，可选）
  • direction：排序方向。（字符串，可选）
  • orderBy：按字段对讨论排序。如果提供，则还需提供 'direction'。（字符串，可选）
  • owner：仓库所有者（字符串，必需）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称。如果未提供，则会在组织级别查询讨论。（字符串，可选）

Gists

• create_gist - 创建 Gist

  • 所需 OAuth 范围：gist
  • content：用于创建简单单文件 gist 的内容（字符串，必需）
  • description：gist 的描述（字符串，可选）
  • filename：用于创建简单单文件 gist 的文件名（字符串，必需）
  • public：gist 是否公开（布尔值，可选）

• get_gist - 获取 Gist 内容

  • gist_id：gist 的 ID（字符串，必需）

• list_gists - 列出 Gist

  • page：分页的页码（最小值为 1）（数字，可选）
  • perPage：分页的每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • since：仅列出此时间之后更新的 Gist（ISO 8601 时间戳）（字符串，可选）
  • username：GitHub 用户名（省略时列出已认证用户的 Gist）（字符串，可选）

• update_gist - 更新 Gist

  • 必需的 OAuth 作用域：gist
  • content：文件内容（字符串，必需）
  • description：更新后的 Gist 描述（字符串，可选）
  • filename：要更新或创建的文件名（字符串，必需）
  • gist_id：要更新的 Gist ID（字符串，必需）

Git

• get_repository_tree - 获取仓库树
  • 必需的 OAuth 作用域：repo
  • owner：仓库所有者（用户名或组织）（字符串，必需）
  • path_filter：用于筛选树结果的可选路径前缀（例如，使用 'src/' 仅显示 src 目录中的文件）（字符串，可选）
  • recursive：将此参数设为 true 时，会返回树引用的对象或子树。默认值为 false（布尔值，可选）
  • repo：仓库名称（字符串，必需）
  • tree_sha：树的 SHA1 值或引用（分支或标签）名称。默认为仓库的默认分支（字符串，可选）

Issues

• add_issue_comment - 为 Issue 或拉取请求添加评论

  • 必需的 OAuth 作用域：repo
  • body：评论内容。除非提供 reaction，否则必需。（字符串，可选）
  • comment_id：要添加 reaction 的 Issue 或拉取请求评论的数字 ID。对评论添加 reaction 时使用此参数；对 Issue 或拉取请求本身添加 reaction 时省略此参数。不能与 body 同时使用。（数字，可选）
  • issue_number：要评论或添加 reaction 的 Issue 或拉取请求编号。（数字，必需）
  • owner：仓库所有者（字符串，必需）
  • reaction：要添加的表情 reaction。除非提供 body，否则必需。（字符串，可选）
  • repo：仓库名称（字符串，必需）

• get_label - 获取仓库中的指定标签

  • 必需的 OAuth 作用域：repo
  • name：标签名称。（字符串，必需）
  • owner：仓库所有者（用户名或组织名称）（字符串，必需）
  • repo：仓库名称（字符串，必需）

• issue_comment_write - 更新或删除 Issue 评论

  • 必需的 OAuth 作用域：repo
  • body：新评论内容（更新操作必需）（字符串，可选）
  • comment_id：要更新或删除的评论 ID（数字，必需）
  • method：要对评论执行的写入操作。 可选项：
    • 'update' - 更新现有评论。
    • 'delete' - 删除现有评论。 （字符串，必需）
  • owner：仓库所有者（字符串，必需）
  • repo：仓库名称（字符串，必需）

• issue_read - 获取议题详情

  • 所需 OAuth 权限范围：repo
  • issue_number：议题编号（数字，必填）
  • method：对单个议题执行的读取操作。 可选项：
    1. get - 获取议题详情。还会尽力返回层级标记（has_parent、has_children）；parent 和 sub_issues_summary 是可选的关系摘要。
    2. get_comments - 获取议题评论。
    3. get_sub_issues - 获取该议题的子议题。
    4. get_parent - 如果该议题是另一个议题的子议题，则获取其父议题。
    5. get_labels - 获取分配给该议题的标签。 （字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必填）

• issue_write - 创建或更新议题/拉取请求

  • 所需 OAuth 权限范围：repo
  • assignees：分配给此议题的用户名（字符串数组，可选）
  • body：议题正文内容（字符串，可选）
  • duplicate_of：此议题重复对应的议题编号。仅当 state_reason 为 'duplicate' 时使用。（数字，可选）
  • issue_fields：要设置或清除的议题字段值。每项都必须包含 'field_name'，且必须且只能包含 'value'、'field_option_name' 或 'delete: true' 中的一项。（对象数组，可选）
  • issue_number：要更新的议题编号（数字，可选）
  • labels：要应用于此议题的标签（字符串数组，可选）
  • method：对单个议题执行的写入操作。 可选项：
    • 'create' - 创建新议题。
    • 'update' - 更新现有议题。 （字符串，必填）
  • milestone：里程碑编号（数字，可选）
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）
  • state：新状态（字符串，可选）
  • state_reason：状态变更原因。仅当状态发生变更时使用。（字符串，可选）
  • title：议题标题（字符串，可选）
  • type：此议题的类型。仅当此仓库启用了议题类型时使用。使用 list_issue_types 工具获取此仓库或其所属组织的有效类型值。如果仓库不支持议题类型，请省略此参数。（字符串，可选）

• list_issue_fields - 列出议题字段

  • 所需 OAuth 权限范围（任一）：repo、read:org
  • 接受的 OAuth 权限范围：admin:org、read:org、repo、write:org
  • owner：仓库或组织的账户所有者。名称不区分大小写。（字符串，必填）
  • repo：仓库名称。提供时，返回此特定仓库的字段（继承自其组织）。省略时，直接返回组织级字段。（字符串，可选）

• list_issue_types - 列出可用的议题类型

  • 所需 OAuth 权限范围（任一）：repo、read:org
  • 接受的 OAuth 权限范围：admin:org、read:org、repo、write:org
  • owner：仓库或组织的账户所有者。（字符串，必填）
  • repo：仓库名称。提供时，返回此特定仓库的议题类型。省略时，直接返回组织级议题类型。（字符串，可选）

• list_issues - 列出议题

  • Required OAuth Scopes：repo
  • after：用于分页的游标。使用上一次响应中的游标。（string，可选）
  • direction：排序方向。如果提供此项，也必须提供 'orderBy'。（string，可选）
  • field_filters：按自定义议题字段值筛选。每个条目包含 field_name 和 value；服务会查找该字段，并将值转换为对应类型（单选选项名称、文本、数字或 YYYY-MM-DD 日期）。（object[]，可选）
  • labels：按标签筛选（string[]，可选）
  • orderBy：按字段对议题排序。如果提供此项，也必须提供 'direction'。（string，可选）
  • owner：仓库所有者（string，必填）
  • perPage：每页结果数（用于分页，最小值 1，最大值 100）（number，可选）
  • repo：仓库名称（string，必填）
  • since：按日期筛选（ISO 8601 时间戳）（string，可选）
  • state：按状态筛选；未提供时，默认返回所有未关闭和已关闭的议题（string，可选）

• search_issues - 搜索议题

  • Required OAuth Scopes：repo
  • order：排序顺序（string，可选）
  • owner：可选的仓库所有者。如果与 repo 一起提供，则仅列出此仓库的议题。（string，可选）
  • page：分页页码（最小值 1）（number，可选）
  • perPage：每页结果数（用于分页，最小值 1，最大值 100）（number，可选）
  • query：使用 GitHub 议题搜索语法的搜索查询（string，必填）
  • repo：可选的仓库名称。如果与 owner 一起提供，则仅列出此仓库的议题。（string，可选）
  • sort：排序字段，按类别匹配数量排序，默认为最佳匹配（string，可选）

• sub_issue_write - 更改子议题

  • Required OAuth Scopes：repo
  • after_id：要排在其后的子议题 ID（必须指定 after_id 或 before_id）（number，可选）
  • before_id：要排在其前的子议题 ID（必须指定 after_id 或 before_id）（number，可选）
  • issue_number：父议题编号（number，必填）
  • method：对单个子议题执行的操作 选项包括：
    • 'add' - 将子议题添加到 GitHub 仓库中的父议题。
    • 'remove' - 从 GitHub 仓库中的父议题移除子议题。
    • 'reprioritize' - 更改 GitHub 仓库中父议题下子议题的顺序。使用 'after_id' 或 'before_id' 指定新位置。 写入议题层级关系。若要将子议题移至新的父议题，请使用 add 并设置 replace_parent=true；没有可写入的父级字段。 （string，必填）
  • owner：仓库所有者（string，必填）
  • replace_parent：为 true 时，替换子议题当前的父议题。仅与 'add' 方法一起使用。（boolean，可选）
  • repo：仓库名称（string，必填）
  • sub_issue_id：要添加的子议题 ID。ID 与议题编号不同（number，必填）

标签

• get_label - 获取仓库中的指定标签

  • Required OAuth Scopes：repo
  • name：标签名称。（string，必填）
  • owner：仓库所有者（用户名或组织名称）（string，必填）
  • repo：仓库名称（string，必填）

• label_write - 仓库标签写入操作

  • Required OAuth Scopes：repo
  • color：标签颜色，使用 6 位十六进制代码，且不带「#」前缀（例如，'f29513'）。「create」时必填，「update」时可选。（字符串，可选）
  • description：标签描述文本。「create」和「update」时均可选。（字符串，可选）
  • method：要执行的操作：「create」、「update」或「delete」（字符串，必填）
  • name：标签名称——所有操作均必填（字符串，必填）
  • new_name：标签的新名称（仅在使用「update」方法重命名时使用）（字符串，可选）
  • owner：仓库所有者（用户名或组织名称）（字符串，必填）
  • repo：仓库名称（字符串，必填）

• list_label - 列出仓库标签

  • Required OAuth Scopes：repo
  • owner：仓库所有者（用户名或组织名称）——所有操作均必填（字符串，必填）
  • repo：仓库名称——所有操作均必填（字符串，必填）

本地 Git

• git_add - Git 添加

  • files：要暂存的文件路径列表，以逗号分隔（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_add - Git 添加

  • files：要暂存的文件路径列表，以逗号分隔（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_apply_patch_file - Git 应用补丁文件

  • patch_file：补丁文件的路径（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_apply_patch_file - Git 应用补丁文件

  • patch_file：补丁文件的路径（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_apply_patch_string - Git 应用补丁字符串

  • patch_string：要应用的补丁字符串（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_apply_patch_string - Git 应用补丁字符串

  • patch_string：要应用的补丁字符串（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_checkout - Git 检出

  • branch_name：要检出的分支名称（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_checkout - Git 检出

  • branch_name：要检出的分支名称（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_commit - Git 提交

  • message：提交说明（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_commit - Git 提交

  • message：提交说明（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_create_branch - Git 创建分支

  • base_branch：新分支的起点（可选）（字符串，可选）
  • branch_name：新分支的名称（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_create_branch - Git 创建分支

  • base_branch：新分支的起点（可选）（字符串，可选）
  • branch_name：新分支的名称（字符串，必填）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_diff - Git 差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • target：要比较的目标分支或提交（字符串，必填）

• git_diff - Git 差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • target：要比较的目标分支或提交（字符串，必填）

• git_diff_staged - Git 暂存区差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_diff_staged - Git 暂存区差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_diff_unstaged - Git 未暂存差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_diff_unstaged - Git 未暂存差异

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_init - Git 初始化

  • repo_path：要初始化为 Git 仓库的目录路径（字符串，必填）

• git_init - Git 初始化

  • repo_path：要初始化为 Git 仓库的目录路径（字符串，必填）

• git_list_repositories - Git 仓库列表

  • 无需参数

• git_list_repositories - Git 仓库列表

  • 无需参数

• git_log - Git 日志

  • max_count：要显示的最大提交数（默认值：10）（数字，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_log - Git 日志

  • max_count：要显示的最大提交数（默认值：10）（数字，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_pull - Git 拉取

  • branch：要拉取的分支名称（默认值：当前分支的上游分支）（字符串，可选）
  • remote：远程名称（默认值：origin）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_pull - Git 拉取

  • branch：要拉取的分支名称（默认值：当前分支的上游分支）（字符串，可选）
  • remote：远程名称（默认值：origin）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_push - Git 推送

  • branch：要推送的分支名称（默认值：当前分支）（字符串，可选）
  • remote：远程名称（默认值：origin）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_push - Git 推送

  • branch：要推送的分支名称（默认值：当前分支）（字符串，可选）
  • remote：远程名称（默认值：origin）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_reset - Git 重置

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_reset - Git 重置

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）

• git_show - Git 显示

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • revision：要显示的修订版本（提交哈希、分支名称、标签）（字符串，必填）

• git_show - Git 显示

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • revision：要显示的修订版本（提交哈希、分支名称、标签）（字符串，必填）

• git_status - Git 状态

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）

• git_status - Git 状态

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）

• git_worktree_add - 添加 Git 工作树

  • commitish：要在新工作树中检出的分支名称、标签或提交 SHA（可选）（字符串，可选）
  • detach：创建分离 HEAD 工作树（可选，默认值：false）（布尔值，可选）
  • force：即使工作树路径已存在，也强制创建（可选，默认值：false）（布尔值，可选）
  • new_branch：在工作树中创建具有此名称的新分支（可选）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree_path：要创建新工作树的位置路径（字符串，必填）

• git_worktree_add - 添加 Git 工作树

  • commitish：要在新工作树中检出的分支名称、标签或提交 SHA（可选）（字符串，可选）
  • detach：创建分离 HEAD 工作树（可选，默认值：false）（布尔值，可选）
  • force：即使工作树路径已存在，也强制创建（可选，默认值：false）（布尔值，可选）
  • new_branch：在工作树中创建具有此名称的新分支（可选）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree_path：要创建新工作树的位置路径（字符串，必填）

• git_worktree_list - 列出 Git 工作树

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）

• git_worktree_list - 列出 Git 工作树

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）

• git_worktree_lock - 锁定 Git 工作树

  • reason：锁定工作树的原因（可选）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree：要锁定的工作树目录路径（字符串，必填）

• git_worktree_lock - 锁定 Git 工作树

  • reason：锁定工作树的原因（可选）（字符串，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree：要锁定的工作树目录路径（字符串，必填）

• git_worktree_prune - 清理 Git 工作树

  • dry_run：显示将要清理的内容，但不实际执行清理（可选，默认值：false）（布尔值，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • verbose：显示详细输出（可选，默认值：false）（布尔值，可选）

• git_worktree_prune - 清理 Git 工作树

  • dry_run：显示将要清理的内容，但不实际执行清理（可选，默认值：false）（布尔值，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • verbose：显示详细输出（可选，默认值：false）（布尔值，可选）

• git_worktree_remove - 移除 Git 工作树

  • force：即使工作树有未提交更改或已锁定，也强制移除（可选，默认值：false）（布尔值，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree：要移除的工作树目录路径（字符串，必填）

• git_worktree_remove - 移除 Git 工作树

  • force：即使工作树有未提交更改或已锁定，也强制移除（可选，默认值：false）（布尔值，可选）
  • repo_path：Git 仓库的路径（如果已配置默认仓库，则为可选）（字符串，可选）
  • worktree：要移除的工作树目录路径（字符串，必填）

• git_worktree_unlock - 解锁 Git worktree

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • worktree：要解锁的 worktree 目录路径（字符串，必填）

• git_worktree_unlock - 解锁 Git worktree

  • repo_path：Git 仓库的路径（如果已配置默认仓库，则可选）（字符串，可选）
  • worktree：要解锁的 worktree 目录路径（字符串，必填）

通知

• dismiss_notification - 忽略通知

  • 必需的 OAuth 权限范围：notifications
  • state：通知的新状态（read/done）（字符串，必填）
  • threadID：通知线程的 ID（字符串，必填）

• get_notification_details - 获取通知详情

  • 必需的 OAuth 权限范围：notifications
  • notificationID：通知的 ID（字符串，必填）

• list_notifications - 列出通知

  • 必需的 OAuth 权限范围：notifications
  • before：仅显示在给定时间之前更新的通知（ISO 8601 格式）（字符串，可选）
  • filter：通知筛选条件；除非另有指定，否则使用默认值。已读通知是指用户已确认的通知。参与中的通知是指用户直接参与的通知，例如用户评论过或创建过的问题或拉取请求。（字符串，可选）
  • owner：可选的仓库所有者。如果与 repo 一起提供，则仅列出此仓库的通知。（字符串，可选）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • repo：可选的仓库名称。如果与 owner 一起提供，则仅列出此仓库的通知。（字符串，可选）
  • since：仅显示在给定时间之后更新的通知（ISO 8601 格式）（字符串，可选）

• manage_notification_subscription - 管理通知订阅

  • 必需的 OAuth 权限范围：notifications
  • action：要执行的操作：忽略、关注或删除通知订阅。（字符串，必填）
  • notificationID：通知线程的 ID。（字符串，必填）

• manage_repository_notification_subscription - 管理仓库通知订阅

  • 必需的 OAuth 权限范围：notifications
  • action：要执行的操作：忽略、关注或删除仓库通知订阅。（字符串，必填）
  • owner：仓库所属账号。（字符串，必填）
  • repo：仓库名称。（字符串，必填）

• mark_all_notifications_read - 将所有通知标记为已读

  • 必需的 OAuth 权限范围：notifications
  • lastReadAt：记录上次检查通知的时间点（可选）。默认值：现在（字符串，可选）
  • owner：可选的仓库所有者。如果与 repo 一起提供，则仅将此仓库的通知标记为已读。（字符串，可选）
  • repo：可选的仓库名称。如果与 owner 一起提供，则仅将此仓库的通知标记为已读。（字符串，可选）

项目

• projects_get - 获取 GitHub Projects 资源的详细信息
  • 必需的 OAuth 作用域：read:project
  • 可接受的 OAuth 作用域：project、read:project
  • field_id：字段 ID。对于 'get_project_field' 方法是必需的。（数字，可选）
  • field_names：获取项目条目时要包含在响应中的特定字段名称列表（例如 ["Status", "Priority"]）。由服务端解析为字段 ID——如果只知道人类可读的名称，请传入此参数而不是 'fields'。不可与 'fields' 同时使用——请提供其中一个，而非两者。仅用于 'get_project_item' 方法。（字符串[]，可选）
  • fields：获取项目条目时要包含在响应中的特定字段 ID 列表（例如 ["102589", "985201", "169875"]）。如果未提供 'fields' 或 'field_names'，则仅包含标题字段。不可与 'field_names' 同时使用——请提供其中一个，而非两者。仅用于 'get_project_item' 方法。（字符串[]，可选）
  • item_id：条目的 ID。对于 'get_project_item' 方法是必需的。（数字，可选）
  • method：要执行的方法（字符串，必需）
  • owner：所有者（用户或组织登录名）。名称不区分大小写。（字符串，可选）
  • owner_type：所有者类型（用户或组织）。如果未提供，将自动检测。（字符串，可选）
  • project_number：项目编号。（数字，可选）
  • status_update_id：项目状态更新的节点 ID。对于 'get_project_status_update' 方法是必需的。（字符串，可选）

拉取请求

• add_reply_to_pull_request_comment - 回复拉取请求评论

  • 必需的 OAuth 作用域：repo
  • body：回复文本。除非提供了 reaction，否则为必需。（字符串，可选）
  • commentId：要回复或添加反应的拉取请求评审评论的数字 ID。请使用 #discussion_r... 锚点中的数字，而不是 GraphQL 线程节点 ID（PRRT_...）。（数字，必需）
  • owner：仓库所有者（字符串，必需）
  • pullNumber：拉取请求编号。提供 body 时必需。（数字，可选）
  • reaction：要添加的表情符号反应。除非提供了 body，否则为必需。（字符串，可选）
  • repo：仓库名称（字符串，必需）

• create_pull_request - 创建新的拉取请求

  • 必需的 OAuth 作用域：repo
  • base：要合并到的分支（字符串，必需）
  • body：PR 描述（字符串，可选）
  • draft：将 PR 创建为草稿（布尔值，可选）
  • head：包含更改的分支（字符串，必需）
  • maintainer_can_modify：允许维护者编辑（布尔值，可选）
  • owner：仓库所有者（字符串，必需）
  • repo：仓库名称（字符串，必需）
  • reviewers：要请求其进行评审的 GitHub 用户名或 ORG/团队 slug 团队评审者（字符串数组，可选）
  • title：PR 标题（字符串，必需）

• list_pull_requests - 列出拉取请求

  • 必需的 OAuth 作用域：repo
  • base：按基准分支筛选（字符串，可选）
  • direction：排序方向（字符串，可选）
  • head：按 head 用户/组织和分支筛选（字符串，可选）
  • owner：仓库所有者（字符串，必需）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • repo：仓库名称（字符串，必需）
  • sort：排序依据（字符串，可选）
  • state：按状态筛选（字符串，可选）

• merge_pull_request - 合并拉取请求

  • 必需的 OAuth 作用域：repo
  • commit_message：合并提交的补充详情（字符串，可选）
  • commit_title：合并提交的标题（字符串，可选）
  • merge_method：合并方式（字符串，可选）
  • owner：仓库所有者（字符串，必需）
  • pullNumber：拉取请求编号（数字，必需）
  • repo：仓库名称（字符串，必需）

• pull_request_comment_write - 更新或删除拉取请求审查评论

  • Required OAuth Scopes：repo
  • body：新的评论内容（update 方法必填）（字符串，可选）
  • comment_id：要更新或删除的审查评论 ID。使用 get_review_comments 返回的 database_id。（数字，必填）
  • method：要对审查评论执行的写入操作。 可选项：
    • 'update' - 更新现有审查评论。
    • 'delete' - 删除现有审查评论。 （字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）

• pull_request_read - 获取单个拉取请求的详细信息

  • Required OAuth Scopes：repo
  • after：分页游标，仅由 get_review_comments 方法使用。传入上一页 PageInfo 中的 endCursor，以获取下一页。（字符串，可选）
  • method：指定要从 GitHub 获取哪种拉取请求数据的操作。 可选项：
    1. get - 获取特定拉取请求的详细信息。
    2. get_diff - 获取拉取请求的差异。
    3. get_status - 获取拉取请求中头部提交的综合提交状态。
    4. get_files - 获取拉取请求中变更文件的列表。搭配分页参数使用，以控制返回结果数量。
    5. get_commits - 获取拉取请求中的提交列表。搭配分页参数使用，以控制返回结果数量。
    6. get_review_comments - 获取拉取请求中的审查讨论串。每个讨论串包含拉取请求审查期间在同一代码位置发表、按逻辑分组的审查评论。返回包含元数据（isResolved、isOutdated、isCollapsed）及相关评论的讨论串。使用基于游标的分页（perPage、after）控制结果。
    7. get_reviews - 获取拉取请求的审查记录。用户要求查看审查评论时，请使用 get_review_comments 方法。搭配分页参数使用，以控制返回结果数量。
    8. get_comments - 获取拉取请求的评论。如果用户没有特别要求查看审查评论，请使用此方法。搭配分页参数使用，以控制返回结果数量。
    9. get_check_runs - 获取拉取请求头部提交的检查运行记录。检查运行记录是针对 PR 运行的单个 CI/CD 作业和检查。 （字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • perPage：每页分页结果数（最小值 1，最大值 100）（数字，可选）
  • pullNumber：拉取请求编号（数字，必填）
  • repo：仓库名称（字符串，必填）

• pull_request_review_write - 对拉取请求审查执行写入操作（创建、提交、删除）

  • Required OAuth Scopes：repo
  • body：审查评论文本（字符串，可选）
  • commitID：要审查的提交 SHA（字符串，可选）
  • event：要执行的审查操作。（字符串，可选）
  • method：对拉取请求审查执行的写入操作。（字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • pullNumber：拉取请求编号（数字，必填）
  • repo：仓库名称（字符串，必填）
  • threadId：审查讨论串的节点 ID（例如，PRRT_kwDOxxx）。resolve_thread 和 unresolve_thread 方法必填。通过 pull_request_read 的 get_review_comments 方法获取讨论串 ID。（字符串，可选）

• search_pull_requests - 搜索拉取请求

  • 所需 OAuth 权限范围：repo
  • order：排序顺序（字符串，可选）
  • owner：可选的仓库所有者。如果与 repo 一起提供，则仅列出此仓库的拉取请求。（字符串，可选）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • query：使用 GitHub 拉取请求搜索语法的搜索查询（字符串，必填）
  • repo：可选的仓库名称。如果与 owner 一起提供，则仅列出此仓库的拉取请求。（字符串，可选）
  • sort：排序字段，按各类别的匹配数排序，默认为最佳匹配（字符串，可选）

• update_pull_request - 编辑拉取请求

  • 所需 OAuth 权限范围：repo
  • base：新的基础分支名称（字符串，可选）
  • body：新的描述（字符串，可选）
  • draft：将拉取请求标记为草稿（true）或可供审查（false）（布尔值，可选）
  • maintainer_can_modify：允许维护者编辑（布尔值，可选）
  • owner：仓库所有者（字符串，必填）
  • pullNumber：要更新的拉取请求编号（数字，必填）
  • repo：仓库名称（字符串，必填）
  • reviewers：要邀请其审查的 GitHub 用户名或 ORG/team-slug 团队审查者（字符串数组，可选）
  • state：新状态（字符串，可选）
  • title：新标题（字符串，可选）

• update_pull_request_branch - 更新拉取请求分支

  • 所需 OAuth 权限范围：repo
  • expectedHeadSha：拉取请求 HEAD 引用的预期 SHA（字符串，可选）
  • owner：仓库所有者（字符串，必填）
  • pullNumber：拉取请求编号（数字，必填）
  • repo：仓库名称（字符串，必填）

仓库

• create_branch - 创建分支

  • 所需 OAuth 权限范围：repo
  • branch：新分支名称（字符串，必填）
  • from_branch：源分支（默认为仓库默认分支）（字符串，可选）
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）

• create_or_update_file - 创建或更新文件

  • 所需 OAuth 权限范围：repo
  • branch：要在其中创建/更新文件的分支（字符串，必填）
  • content：文件内容（字符串，必填）
  • message：提交消息（字符串，必填）
  • owner：仓库所有者（用户名或组织）（字符串，必填）
  • path：创建/更新文件的路径（字符串，必填）
  • repo：仓库名称（字符串，必填）
  • sha：被替换文件的 blob SHA。文件已存在时必填。（字符串，可选）

• create_repository - 创建仓库

  • 所需 OAuth 权限范围：repo
  • autoInit：使用 README 初始化（布尔值，可选）
  • description：仓库描述（字符串，可选）
  • name：仓库名称（字符串，必填）
  • organization：要在其中创建仓库的组织（省略时将在你的个人账户中创建）（字符串，可选）
  • private：仓库是否应为私有。省略时默认为 true（私有）。（布尔值，可选）

• delete_file - 删除文件

  • 所需 OAuth 权限范围：repo
  • branch：要从中删除文件的分支（字符串，必填）
  • message：提交消息（字符串，必填）
  • owner：仓库所有者（用户名或组织）（字符串，必填）
  • path：要删除的文件路径（字符串，必填）
  • repo：仓库名称（字符串，必填）

• get_commit - 获取提交详情

  • 所需 OAuth 权限范围：repo
  • detail：更改文件的详细程度。"none" 表示完全省略统计信息和文件。"stats"（默认值）包含每个文件的元数据：文件名、状态和代码行数（新增、删除、更改），但不包含补丁内容。"full_patch" 还会包含每个文件的统一差异内容，可能会非常庞大。（字符串，可选）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必填）
  • sha：提交 SHA、分支名称或标签名称（字符串，必填）

• get_file_contents - 获取文件或目录内容

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（用户名或组织）（字符串，必填）
  • path：文件/目录路径（字符串，可选）
  • ref：可接受可选的 git 引用，例如 refs/tags/{tag}、refs/heads/{branch} 或 refs/pull/{pr_number}/head（字符串，可选）
  • repo：仓库名称（字符串，必填）
  • sha：可接受可选的提交 SHA。若指定，将优先于 ref 使用（字符串，可选）

• get_latest_release - 获取最新发布版本

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）

• get_release_by_tag - 按标签名称获取发布版本

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）
  • tag：标签名称（例如，'v1.0.0'）（字符串，必填）

• get_tag - 获取标签详情

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）
  • tag：标签名称（字符串，必填）

• list_branches - 列出分支

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必填）

• list_commits - 列出提交

  • 所需 OAuth 权限范围：repo
  • author：用于筛选提交的作者用户名或电子邮件地址（字符串，可选）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • path：仅返回包含此文件路径的提交（字符串，可选）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必填）
  • sha：要列出其提交记录的提交 SHA、分支或标签名称。若未提供，则使用仓库的默认分支。若提供提交 SHA，则列出截至该 SHA 的提交。（字符串，可选）
  • since：仅返回此日期之后的提交（ISO 8601 格式：YYYY-MM-DDTHH:MM:SSZ 或 YYYY-MM-DD）（字符串，可选）
  • until：仅返回此日期之前的提交（ISO 8601 格式：YYYY-MM-DDTHH:MM:SSZ 或 YYYY-MM-DD）（字符串，可选）

• list_releases - 列出发布版本

  • 所需 OAuth 权限范围：repo
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值 1）（数字，可选）
  • perPage：每页结果数（最小值 1，最大值 100）（数字，可选）
  • repo：仓库名称（字符串，必填）

• list_repository_collaborators - 列出仓库协作者

  • Required OAuth Scopes：repo
  • affiliation：按关联类型筛选。可选值：'outside'（外部协作者）、'direct'（所有拥有权限的协作者，无论是否属于组织）、'all'（所有协作者）。默认值：'all'（字符串，可选）
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（默认值为 1，最小值为 1）（数字，可选）
  • perPage：每页结果数（默认值为 30，最小值为 1，最大值为 100）（数字，可选）
  • repo：仓库名称（字符串，必填）

• list_tags - 列出标签

  • Required OAuth Scopes：repo
  • owner：仓库所有者（字符串，必填）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • repo：仓库名称（字符串，必填）

• push_files - 将文件推送到仓库

  • Required OAuth Scopes：repo
  • branch：要推送到的分支（字符串，必填）
  • files：要推送的文件对象数组，每个对象包含 path（字符串）和 content（字符串）（对象数组，必填）
  • message：提交消息（字符串，必填）
  • owner：仓库所有者（字符串，必填）
  • repo：仓库名称（字符串，必填）

• search_code - 搜索代码

  • Required OAuth Scopes：repo
  • order：结果排序顺序（字符串，可选）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • query：搜索查询（GitHub 代码搜索 REST）。词项之间隐式使用 AND；支持 OR、NOT 和用于精确匹配的 "quoted phrase"。限定符：repo:owner/repo、org:、user:、language:、path:dir（前缀匹配）、filename:exact.ext、extension:、in:file、in:path、size:、is:archived、is:fork。最多 256 个字符。示例：WithContext language:go org:github；"package main" repo:o/r；func extension:go path:cmd repo:o/r；NOT TODO language:go repo:o/r。（字符串，必填）
  • sort：排序字段（仅限 'indexed'）（字符串，可选）

• search_commits - 搜索提交

  • Required OAuth Scopes：repo
  • order：排序顺序（字符串，可选）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • query：提交搜索查询（GitHub 提交搜索 REST）。仅搜索默认分支上的提交消息。使用 repo:owner/repo、org: 或 user: 限定搜索范围（不带范围限定符的查询会匹配整个 GitHub，通常不是你想要的结果）。其他限定符：author:、committer:、author-name:、committer-name:、author-email:、committer-email:、author-date:、committer-date:（支持 >、<、>=、<= 和 YYYY-MM-DD..YYYY-MM-DD 范围）、merge:true|false、hash:、tree:、parent:、is:public。示例：repo:owner/repo fix panic；org:github author:defunkt committer-date:>=2024-01-01；"refactor cache" repo:o/r；hash:abc1234 repo:o/r。（字符串，必填）
  • sort：按作者或提交者日期排序（默认按最佳匹配排序）（字符串，可选）

• search_repositories - 搜索仓库

  • Required OAuth Scopes：repo
  • minimal_output：返回最精简的仓库信息（默认值：true）。设为 false 时，返回完整的 GitHub API 仓库对象。（布尔值，可选）
  • order：排序顺序（字符串，可选）
  • page：分页页码（最小值为 1）（数字，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（数字，可选）
  • query：仓库搜索查询。示例：'machine learning in:name stars:>1000 language:python'、'topic:react'、'user:facebook'。支持高级搜索语法，以便精确筛选。（字符串，必填）
  • sort：按字段对仓库排序，默认按最佳匹配排序（字符串，可选）

密钥保护

• get_secret_scanning_alert - 获取密钥扫描警报

  • 必需的 OAuth 作用域：security_events
  • 接受的 OAuth 作用域：repo、security_events
  • alertNumber：警报编号。（number，必需）
  • owner：仓库所有者。（string，必需）
  • repo：仓库名称。（string，必需）

• list_secret_scanning_alerts - 列出密钥扫描警报

  • 必需的 OAuth 作用域：security_events
  • 接受的 OAuth 作用域：repo、security_events
  • owner：仓库所有者。（string，必需）
  • page：分页页码（最小值为 1）（number，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（number，可选）
  • repo：仓库名称。（string，必需）
  • resolution：按解决方式筛选（string，可选）
  • secret_type：以逗号分隔的要返回的密钥类型列表。默认返回所有默认密钥模式。要返回通用模式，请在此参数中传入令牌名称。（string，可选）
  • state：按状态筛选（string，可选）

安全公告

• get_global_security_advisory - 获取全局安全公告

  • 必需的 OAuth 作用域：security_events
  • 接受的 OAuth 作用域：repo、security_events
  • ghsaId：GitHub 安全公告 ID（格式：GHSA-xxxx-xxxx-xxxx）。（string，必需）

• list_global_security_advisories - 列出全局安全公告

  • 必需的 OAuth 作用域：security_events
  • 接受的 OAuth 作用域：repo、security_events
  • affects：按受影响的软件包或版本筛选公告（例如 "package1,[email protected]"）。（string，可选）
  • cveId：按 CVE ID 筛选。（string，可选）
  • cwes：按通用弱点枚举 ID 筛选（例如 ["79", "284", "22"]）。（string[]，可选）
  • ecosystem：按软件包生态系统筛选。（string，可选）
  • ghsaId：按 GitHub 安全公告 ID 筛选（格式：GHSA-xxxx-xxxx-xxxx）。（string，可选）
  • isWithdrawn：是否仅返回已撤回的公告。（boolean，可选）
  • modified：按发布日期、更新日期或日期范围筛选（ISO 8601 日期或范围）。（string，可选）
  • published：按发布日期或日期范围筛选（ISO 8601 日期或范围）。（string，可选）
  • severity：按严重程度筛选。（string，可选）
  • type：公告类型。（string，可选）
  • updated：按更新日期或日期范围筛选（ISO 8601 日期或范围）。（string，可选）

• list_org_repository_security_advisories - 列出组织仓库的安全公告

  • 必需的 OAuth 作用域：security_events
  • 接受的 OAuth 作用域：repo、security_events
  • direction：排序方向。（string，可选）
  • org：组织登录名。（string，必需）
  • sort：排序字段。（string，可选）
  • state：按公告状态筛选。（string，可选）

获得星标的用户

• list_starred_repositories - 列出已加星标的仓库

  • Required OAuth Scopes: repo
  • direction：结果的排序方向。（string，可选）
  • page：分页页码（最小值为 1）（number，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（number，可选）
  • sort：结果的排序方式。可以是 'created'（仓库获得星标的时间）或 'updated'（仓库上次推送的时间）。（string，可选）
  • username：要列出其已加星标仓库的用户名。默认为已通过身份验证的用户。（string，可选）

• star_repository - 为仓库加星标

  • Required OAuth Scopes: repo
  • owner：仓库所有者（string，必填）
  • repo：仓库名称（string，必填）

• unstar_repository - 取消仓库星标

  • Required OAuth Scopes: repo
  • owner：仓库所有者（string，必填）
  • repo：仓库名称（string，必填）

用户

• search_users - 搜索用户
  • Required OAuth Scopes: repo
  • order：排序顺序（string，可选）
  • page：分页页码（最小值为 1）（number，可选）
  • perPage：每页结果数（最小值为 1，最大值为 100）（number，可选）
  • query：用户搜索查询。示例：'john smith'、'location:seattle'、'followers:>100'。搜索范围会自动限定为 type:user。（string，必填）
  • sort：按关注者数量、仓库数量或用户加入 GitHub 的时间排序。（string，可选）

• create_pull_request_with_copilot - 使用 GitHub Copilot 编码 Agent 执行任务
  • owner：仓库所有者。你可以猜测所有者，但在继续操作前请向用户确认。（字符串，必填）
  • repo：仓库名称。你可以猜测仓库名称，但在继续操作前请向用户确认。（字符串，必填）
  • problem_statement：要执行任务的详细描述（例如，“实现一项可执行 X 的功能”、“修复错误 Y”等）。（字符串，必填）
  • title：要创建的拉取请求标题（字符串，必填）
  • base_ref：Agent 开始工作的 Git 引用（例如分支）。如果未指定，则默认为仓库的默认分支（字符串，可选）

• 身份验证说明

  • 细粒度 PAT 不会受到经典 PAT 作用域筛选的隐藏，因此即使令牌无法使用这些工具，它们仍可能会显示。
  • 对于组织拥有的空间，细粒度 PAT 必须安装在所属组织中，并包含 organization_copilot_spaces: read。
  • 如果组织拥有的空间包含由仓库提供支持的资源，令牌还必须有权访问所有被引用的仓库，否则该空间可能会被视为不存在。

• get_copilot_space - 获取 Copilot Space

  • owner：空间的所有者。（字符串，必填）
  • name：空间名称。（字符串，必填）

• list_copilot_spaces - 列出 Copilot Spaces

• github_support_docs_search - 检索相关文档，以回答 GitHub 产品和支持相关问题。支持主题包括：GitHub Actions 工作流、身份验证、GitHub 支持咨询、拉取请求实践、仓库维护、GitHub Pages、GitHub Packages、GitHub Discussions、Copilot Spaces
  • query：用户关于所需答案的问题输入。这是用户最新的原始未编辑消息。你应始终保持用户消息原样，不应对其进行任何修改。（字符串，必填）