GitHub 工作流调试器 MCP
使用 GitHub API 诊断和修复 GitHub Actions 工作流程故障的多选提示 (MCP) 实用程序。
概述
该工具通过结构化决策树帮助用户诊断和修复 GitHub Actions 工作流程故障。它使用 GitHub API 获取工作流程运行信息、分析故障并提供可行的解决方案。
特征
- 获取存储库最近失败的工作流程运行
- 分析工作流运行作业和步骤
- 识别常见的故障模式
- 针对常见问题提出具体修复建议
- 查看和更新工作流文件
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 githubworkflowmcp:
手动安装
用法
GitHub Workflow Debugger MCP 旨在与支持模型上下文协议 (MCP) 的 AI 助手配合使用。它提供了多种工具,可用于诊断和修复 GitHub Actions 工作流故障。
所需权限
要使用此工具,您需要具有以下权限的 GitHub 个人访问令牌 (PAT):
repo
- 完全控制私有存储库workflow
- 更新 GitHub Action 工作流程
您必须将此令牌设置为名为GITHUB_PERSONAL_ACCESS_TOKEN
的环境变量。
配置
当与兼容 MCP 的客户端一起使用此工具时,您可以按如下方式进行配置:
将<YOUR_TOKEN>
替换为您的 GitHub 个人访问令牌。
可用工具
- get-failed-workflow-runs - 获取存储库中最近失败的工作流程运行
- get-workflow-run-jobs - 获取特定工作流运行的作业
- get-workflow-file - 检索工作流文件的内容
- update-workflow-file - 使用修复程序更新工作流文件
- analyze-workflow-failure - 分析失败的工作流程运行并提出修复建议
示例用法
以下是如何将 GitHub Workflow Debugger MCP 与 AI 助手一起使用的示例:
- 首先,获取最近失败的工作流程运行:
- 分析特定的失败运行:
- 查看工作流文件:
- 使用修复程序更新工作流文件:
发展
先决条件
- Node.js 16 或更高版本
- npm 或 yarn
设置
项目结构
src/index.ts
- MCP 服务器的主入口点build/
——编译的 JavaScript 文件
执照
国际学习中心
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
该实用程序通过分析运行日志、识别常见故障模式并通过结构化决策树建议特定的修复方法来帮助诊断和修复 GitHub Actions 工作流故障。
Related MCP Servers
- -securityAlicense-qualityProvides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.Last updated -41431TypeScriptMIT License
- -securityFlicense-qualityEnables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.Last updated -91TypeScript
- AsecurityAlicenseAqualityHelps support engineers find similar GitHub issues to speed up troubleshooting by searching repositories and calculating similarity scores based on issue descriptions.Last updated -1TypeScriptMIT License
- AsecurityFlicenseAqualityAn MCP server that enables AI assistants to manage GitHub Actions workflows by providing tools for listing, viewing, triggering, canceling, and rerunning workflows through the GitHub API.Last updated -95233TypeScript