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.

Integrations

Provides access to GitHub repository data, allowing interaction with repositories to manage GitHub Actions workflows and analyze their execution.
Enables complete workflow management including listing, viewing, triggering, canceling, and rerunning workflows, as well as analyzing workflow runs and their jobs in GitHub repositories.

GitHub Actions MCP 서버

GitHub Actions API를 위한 MCP 서버로, AI 어시스턴트가 GitHub Actions 워크플로를 관리하고 운영할 수 있도록 지원합니다.

특징

완벽한 워크플로 관리 : 워크플로 나열, 보기, 트리거, 취소 및 다시 실행
워크플로 실행 분석 : 워크플로 실행 및 해당 작업에 대한 자세한 정보를 얻으세요.
포괄적인 오류 처리 : 향상된 세부 정보를 포함한 명확한 오류 메시지
유연한 유형 검증 : API 변형을 우아하게 처리하여 강력한 유형 검사
보안 중심 설계 : 시간 초과 처리, 속도 제한 및 엄격한 URL 유효성 검사

도구

list_workflows
- GitHub 저장소의 워크플로 나열
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - page (선택적 숫자): 페이지 번호
  - perPage (선택적 숫자): 페이지당 결과(최대 100개)
- 반환: 저장소의 워크플로 목록
get_workflow
- 특정 워크플로의 세부 정보 가져오기
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - workflowId (문자열 또는 숫자): 워크플로 또는 파일 이름의 ID
- 반환: 워크플로에 대한 자세한 정보
get_workflow_usage
- 워크플로우의 사용 통계 가져오기
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - workflowId (문자열 또는 숫자): 워크플로 또는 파일 이름의 ID
- 반환: 청구 가능한 시간을 포함한 사용 통계
list_workflow_runs
- 저장소 또는 특정 워크플로에 대한 모든 워크플로 실행을 나열합니다.
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - workflowId (선택적 문자열 또는 숫자): 워크플로 또는 파일 이름의 ID
  - actor (선택 문자열): 워크플로를 트리거한 사용자로 필터링
  - branch (선택적 문자열): branch로 필터링
  - event (선택 문자열): 이벤트 유형별 필터링
  - status (선택 문자열): 상태별 필터링
  - created (선택 문자열): 생성 날짜(YYYY-MM-DD)로 필터링
  - excludePullRequests (선택적 부울): PR 트리거 실행 제외
  - checkSuiteId (선택적 숫자): 체크 스위트 ID로 필터링
  - page (선택적 숫자): 페이지 번호
  - perPage (선택적 숫자): 페이지당 결과(최대 100개)
- 반환: 기준과 일치하는 워크플로 실행 목록
get_workflow_run
- 특정 워크플로 실행에 대한 세부 정보 가져오기
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - runId (숫자): 워크플로 실행의 ID
- 반환: 특정 워크플로 실행에 대한 자세한 정보
get_workflow_run_jobs
- 특정 워크플로 실행에 대한 작업 가져오기
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - runId (숫자): 워크플로 실행의 ID
  - filter (선택적 문자열): 완료 상태('최신', '모두')로 작업을 필터링합니다.
  - page (선택적 숫자): 페이지 번호
  - perPage (선택적 숫자): 페이지당 결과(최대 100개)
- 반환: 워크플로 실행의 작업 목록
trigger_workflow
- 워크플로 실행 트리거
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - workflowId (문자열 또는 숫자): 워크플로 또는 파일 이름의 ID
  - ref (문자열): 워크플로를 실행할 참조(분기, 태그 또는 SHA)
  - inputs (선택적 객체): 워크플로에 대한 입력 매개변수
- 반환: 트리거된 워크플로 실행에 대한 정보
cancel_workflow_run
- 워크플로 실행 취소
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - runId (숫자): 워크플로 실행의 ID
- 반환: 취소 작업의 상태
rerun_workflow
- 워크플로 실행을 다시 실행합니다.
- 입력:
  - owner (문자열): 저장소 소유자(사용자 이름 또는 조직)
  - repo (문자열): 저장소 이름
  - runId (숫자): 워크플로 실행의 ID
- 반환: 재실행 작업의 상태

Claude Desktop과 함께 사용

먼저 프로젝트를 빌드했는지 확인하세요(아래 빌드 섹션 참조). 그런 다음 claude_desktop_config.json 파일에 다음을 추가하세요.

지엑스피1

짓다

저장소를 복제하고 빌드합니다.

git clone https://github.com/ko1ynnky/github-actions-mcp-server.git
cd github-actions-mcp-server
npm install
npm run build

이렇게 하면 MCP 서버를 실행하는 데 필요한 파일이 dist 디렉토리에 생성됩니다.

사용 예

저장소의 워크플로 나열:

const result = await listWorkflows({
  owner: "your-username",
  repo: "your-repository"
});

워크플로 트리거:

const result = await triggerWorkflow({
  owner: "your-username",
  repo: "your-repository",
  workflowId: "ci.yml",
  ref: "main",
  inputs: {
    environment: "production"
  }
});

문제 해결

일반적인 문제

인증 오류 :
- GitHub 토큰에 올바른 권한이 있는지 확인하세요.
- 토큰이 환경 변수로 올바르게 설정되었는지 확인하세요.
속도 제한 :
- 서버는 GitHub API 제한에 도달하지 않도록 속도 제한을 구현합니다.
- 속도 제한 오류가 발생하면 요청 빈도를 줄이십시오.
유형 검증 오류 :
- GitHub API 응답은 예상 스키마와 다를 수 있습니다.
- 서버는 대부분의 변형을 처리하기 위해 유연한 검증을 구현합니다.
- 지속적으로 오류가 발생하는 경우 문제를 열어주세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

GitHub API를 통해 워크플로를 나열, 보기, 트리거, 취소 및 다시 실행하기 위한 도구를 제공하여 AI 어시스턴트가 GitHub Actions 워크플로를 관리할 수 있도록 하는 MCP 서버입니다.

Appeared in Searches

Using MCP server to manage GitHub Actions