mcp-github-tools

AI 에이전트를 위한 GitHub 분석 및 관리 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 표준화된 도구 인터페이스를 통해 저장소 분석, 풀 리퀘스트 요약, 이슈 분류, 릴리스 노트 생성, 기여자 활동 추적을 수행할 수 있습니다.

도구

github_repo_analyzer

GitHub 저장소를 분석하여 스타 수, 포크 수, 오픈 이슈 수, 언어별 비중, 주요 기여자, 주간 커밋 활동 추세를 포함한 종합적인 개요를 제공합니다.

github_pr_summarizer

diff 통계, 파일 변경 사항 분류, 리뷰 상태(승인, 변경 요청, 대기 중인 리뷰어), 최근 댓글 발췌를 포함한 풀 리퀘스트 요약을 제공합니다.

github_issue_triage

저장소의 오픈 이슈를 분석합니다. 라벨과 키워드(버그, 기능, 문서, 보안 등)를 기준으로 이슈를 자동 분류하고, 참여도와 경과 기간을 기반으로 우선순위를 제안하며, 텍스트 유사성을 사용하여 잠재적 중복 이슈를 식별하고, 오래된 이슈를 표시합니다.

github_release_notes

두 참조 지점(태그, 브랜치 또는 SHA) 사이의 커밋에서 릴리스 노트를 생성합니다. conventional commit 패턴을 사용하여 커밋을 분류하고 Markdown 및 구조화된 JSON 출력을 모두 생성합니다.

github_contributor_stats

구성 가능한 시간 범위 내의 기여자 통계를 제공합니다: 커밋, 열린/병합된 PR, 코드 리뷰, 그리고 첫 기여자 식별.

Related MCP server: GitHub MCP Server

요구 사항

• Node.js 18 이상

• 공개 저장소에는 인증 불필요

• 더 높은 rate limit을 위한 선택적 GitHub 개인 액세스 토큰(시간당 60회 vs 5,000회 요청)

설치

git clone https://github.com/rog0x/mcp-github-tools.git
cd mcp-github-tools
npm install
npm run build

구성

Claude Desktop

Claude Desktop 구성 파일에 추가하세요:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-github-tools/dist/index.js"]
    }
  }
}

Claude Code

CLI를 사용하여 서버를 추가하세요:

claude mcp add github-tools node D:/products/mcp-servers/mcp-github-tools/dist/index.js

또는 .claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "github-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-github-tools/dist/index.js"]
    }
  }
}

사용 예시

연결되면 도구는 AI 에이전트에서 자동으로 사용할 수 있습니다. 다음은 예시 프롬프트입니다:

• "facebook/react 저장소 분석"

• "vercel/next.js의 PR #1234 요약"

• "microsoft/vscode의 오픈 이슈 분류"

• "rust-lang/rust의 1.75.0에서 1.76.0까지 릴리스 노트 생성"

• "nodejs/node의 최근 30일 기여자 통계 표시"

GitHub 토큰

모든 도구는 인증된 요청을 위한 선택적 token 매개변수를 허용합니다. 토큰이 없으면 GitHub API는 시간당 60회 요청을 허용합니다. 토큰이 있으면 한도가 시간당 5,000회 요청으로 증가합니다.

개인 액세스 토큰은 github.com/settings/tokens에서 생성할 수 있습니다. 공개 저장소 접근에는 특별한 범위가 필요하지 않습니다.

라이선스

MIT