GitHub MCP

GitHub App 설치를 통해 선택된 GitHub 저장소를 조회하기 위한 범용의 읽기 전용 원격 MCP 커넥터입니다. 자체 호스팅용으로 설계되었으며 GitHub, Cloudflare 또는 MCP 클라이언트 계정 식별자를 포함하지 않습니다.

커넥터는 두 가지 인가 계층을 사용합니다.

1. 사용자가 GitHub App을 인가하여 GitHub 신원을 증명합니다. 운영자가 구성한 로그인만 연결을 완료할 수 있습니다.

2. 도구 호출은 요청된 설치된 저장소로 제한되는 단기 GitHub App 설치 토큰을 사용합니다.

GitHub 사용자 토큰은 신원 확인 후 폐기됩니다. 커넥터는 쓰기 도구를 노출하지 않습니다.

기능

• GitHub App 설치에서 선택된 저장소를 탐색합니다.

• 코드를 검색하고 텍스트 파일 또는 디렉터리 목록을 가져옵니다.

• 커밋, 풀 리퀘스트, diff, 리뷰와 댓글을 검토합니다.

• 이슈와 이슈 댓글을 검토합니다.

• OAuth, PKCE, Dynamic Client Registration 기반으로 원격 MCP 클라이언트를 인증합니다.

Related MCP server: GitHub MCP Server

로컬 개발

요구 사항: Node 22 이상 및 Yarn 1.22.

yarn install
yarn type-check
yarn lint
yarn test
yarn build

테스트는 가짜 신원과 모의(mock) GitHub 서비스를 사용합니다. 로컬 검증에 GitHub App 또는 Cloudflare 계정이 필요하지 않습니다.

실제 서비스에서 Worker를 실행하려면 운영자 설정 가이드를 따르세요. wrangler.jsonc, 로컬 시크릿, GitHub App 개인 키를 커밋하지 마세요.

MCP 도구

결과는 실시간 GitHub API 응답을 정식 GitHub URL이 포함된 제한된 JSON으로 정규화한 것입니다. 페이지네이션의 기본값은 20개 항목이며, 최대 50개로 제한됩니다. 텍스트와 diff 출력은 100,000자로 제한됩니다.

보안 모델

• AUTHORIZED_GITHUB_LOGINS는 필수이며, 비어 있으면 기본적으로 모든 요청을 차단합니다.

• GitHub App 설치가 커넥터가 접근할 수 있는 저장소를 결정합니다.

• 각 저장소 도구 호출 시 해당 저장소로 제한된 1시간 토큰을 발급합니다.

• 필요한 GitHub App 권한은 읽기 전용 Metadata, Contents, Issues 및 Pull Requests입니다.

• OAuth 코드, 사용자 토큰, 설치 토큰, 클라이언트 시크릿, 개인 키는 절대 반환되거나 의도적으로 로그에 기록되지 않습니다.

이 프로젝트는 호스팅형 멀티 테넌트 서비스가 아니라 개인 또는 소규모 팀용 커넥터입니다.

라이선스

이 프로젝트는 MIT License로 제공됩니다.