GitHub Workflow Debugger MCP

一个使用 GitHub API 诊断和修复 GitHub Actions 工作流失败的多项选择提示 (MCP) 实用程序。

概述

此工具通过结构化的决策树帮助用户诊断和修复 GitHub Actions 工作流失败。 它使用 GitHub API 获取工作流运行信息，分析失败原因，并提供可操作的解决方案。

功能

• 获取仓库最近失败的工作流运行
• 分析工作流运行作业和步骤
• 识别常见的失败模式
• 针对常见问题提出具体的修复建议
• 查看和更新工作流文件

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 githubworkflowmcp，请执行以下操作：

npx -y @smithery/cli install @Maxteabag/githubworkflowmcp --client claude

手动安装

# 克隆仓库
git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 链接二进制文件以供本地使用
npm link

用法

GitHub Workflow Debugger MCP 旨在与支持模型上下文协议 (MCP) 的 AI 助手一起使用。 它提供了多种工具，可用于诊断和修复 GitHub Actions 工作流失败。

所需权限

要使用此工具，您需要一个具有以下权限的 GitHub 个人访问令牌 (PAT)：

• repo - 完全控制私有仓库
• workflow - 更新 GitHub Action 工作流

您必须将此令牌设置为名为 GITHUB_PERSONAL_ACCESS_TOKEN 的环境变量。

配置

将此工具与 MCP 兼容的客户端一起使用时，您可以按如下方式配置它：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

将 <YOUR_TOKEN> 替换为您的 GitHub 个人访问令牌。

可用工具

1. get-failed-workflow-runs - 获取仓库最近失败的工作流运行
2. get-workflow-run-jobs - 获取特定工作流运行的作业
3. get-workflow-file - 检索工作流文件的内容
4. update-workflow-file - 使用修复更新工作流文件
5. analyze-workflow-failure - 分析失败的工作流运行并提出修复建议

使用示例

以下是如何将 GitHub Workflow Debugger MCP 与 AI 助手一起使用的示例：

1. 首先，获取最近失败的工作流运行：

   我需要检查我的仓库 "username/repo" 最近失败的工作流运行。
   

2. 分析特定的失败运行：

   你能分析工作流运行 #123456 并提出修复建议吗？
   

3. 查看工作流文件：

   显示我 .github/workflows/main.yml 的工作流文件的内容
   

4. 使用修复更新工作流文件：

   使用建议的修复更新工作流文件。
   

开发

前提条件

• Node.js 16 或更高版本
• npm 或 yarn

设置

# 安装依赖
npm install

# 构建项目
npm run build

项目结构

• src/index.ts - MCP 服务器的主要入口点
• build/ - 编译后的 JavaScript 文件

许可证

ISC