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

실행 로그를 분석하고, 일반적인 실패 패턴을 식별하고, 구조화된 의사 결정 트리를 통해 구체적인 수정 사항을 제안하여 GitHub Actions 워크플로 실패를 진단하고 해결하는 데 도움이 되는 유틸리티입니다.