GitHub Workflow Debugger MCP
2025.03.10
0
TypeScriptGitHub工具工作流调试CI/CD工具开发效率
GitHub Workflow Debugger MCP 是一个用于诊断和修复 GitHub Actions 工作流失败的多选提示工具。它通过 GitHub API 获取工作流运行信息，分析失败原因，并提供可操作的解决方案。
View on GitHub
Overview
基本能力
产品定位
GitHub Workflow Debugger MCP 是一个专门用于诊断和修复 GitHub Actions 工作流失败的工具，旨在提高开发者在处理 CI/CD 流程中的效率。
核心功能
- 获取仓库最近失败的工作流运行
- 分析工作流运行的作业和步骤
- 识别常见的失败模式
- 为常见问题提供具体的修复建议
- 查看和更新工作流文件
适用场景
- 当 GitHub Actions 工作流失败时，快速诊断问题
- 需要分析工作流运行细节以找出失败原因
- 需要自动或半自动修复常见的工作流问题
- 需要查看或修改工作流文件内容
工具列表
- get-failed-workflow-runs - 获取仓库最近失败的工作流运行
- get-workflow-run-jobs - 获取特定工作流运行的作业
- get-workflow-file - 检索工作流文件内容
- update-workflow-file - 使用修复更新工作流文件
- analyze-workflow-failure - 分析失败的工作流运行并提供修复建议
常见问题解答
- 权限问题：需要 GitHub 个人访问令牌(PAT)并设置
GITHUB_PERSONAL_ACCESS_TOKEN环境变量 - 安装问题：可通过 Smithery 自动安装或手动克隆仓库安装
使用教程
使用依赖
- Node.js 16 或更高版本
- npm 或 yarn
安装教程
通过 Smithery 安装
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
调试方式
- 获取最近失败的工作流运行:
I need to check recent failed workflow runs for my repository "username/repo".
- 分析特定失败运行:
Can you analyze workflow run #123456 and suggest fixes?
- 查看工作流文件:
Show me the content of the workflow file at .github/workflows/main.yml
- 更新工作流文件:
Update the workflow file with the suggested fixes.