GitHub 워크플로 디버거 MCP

GitHub API를 사용하여 GitHub Actions 워크플로 오류를 진단하고 수정하기 위한 다중 선택 프롬프트(MCP) 유틸리티입니다.

개요

이 도구는 사용자가 구조화된 의사결정 트리를 통해 GitHub Actions 워크플로 오류를 진단하고 해결할 수 있도록 지원합니다. GitHub API를 사용하여 워크플로 실행 정보를 가져오고, 오류를 분석하고, 실행 가능한 해결책을 제공합니다.

특징

저장소에 대한 최근 실패한 워크플로 실행 가져오기
워크플로 실행 작업 및 단계 분석
일반적인 실패 패턴 식별
일반적인 문제에 대한 구체적인 수정 사항을 제안합니다.
워크플로 파일 보기 및 업데이트

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 githubworkflowmcp를 자동으로 설치하려면:

지엑스피1

수동 설치

# Clone the repository
git clone https://github.com/yourusername/github-workflow-debugger-mcp.git
cd github-workflow-debugger-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link the binary for local use
npm link

용법

GitHub 워크플로 디버거 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 개인 액세스 토큰으로 바꾸세요.

사용 가능한 도구

get-failed-workflow-runs - 저장소에 대한 최근 실패한 워크플로 실행을 가져옵니다.
get-workflow-run-jobs - 특정 워크플로 실행에 대한 작업을 가져옵니다.
get-workflow-file - 워크플로 파일의 내용을 검색합니다.
update-workflow-file - 수정 사항을 적용하여 워크플로 파일을 업데이트합니다.
analyze-workflow-failure - 실패한 워크플로 실행을 분석하고 수정 사항을 제안합니다.

사용 예

다음은 AI 어시스턴트와 함께 GitHub Workflow Debugger MCP를 사용하는 방법의 예입니다.

먼저, 최근에 실패한 워크플로 실행을 가져옵니다.
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.

개발

필수 조건

Node.js 16 이상
npm 또는 yarn

설정

# Install dependencies
npm install

# Build the project
npm run build

프로젝트 구조

src/index.ts - MCP 서버의 주요 진입점
build/ - 컴파일된 JavaScript 파일

특허

아이에스씨

This server cannot be installed

security - not tested

license - not tested

quality - not tested

How are these scores calculated?

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

mcp-github-project-manager
kunwarVivek
A
security
A
license
A
quality
Provides 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 -
46
37
37
TypeScript
MIT License
GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables 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 -
9
1
TypeScript
GitHub Support Assistant
Jake-Mok-Nelson
A
security
A
license
A
quality
Helps support engineers find similar GitHub issues to speed up troubleshooting by searching repositories and calculating similarity scores based on issue descriptions.
Last updated -
1
TypeScript
MIT License
GitHub Actions MCP Server
ko1ynnky
A
security
F
license
A
quality
An 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 -
9
16
37
TypeScript

View all related MCP servers

GitHub Workflow Debugger MCP