GitHub MCP 브리지

MCP GITHUB 엔터프라이즈 🌉

AI 에이전트(Claude, ChatGPT 등)가 GitHub Enterprise 라이선스 데이터를 쿼리할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. /consumed-licenses 엔드포인트를 통해 라이선스 요약, 사용자별 정보, 조직 멤버십 및 엔터프라이즈 역할을 안전하게 가져올 수 있습니다.

📊 기능 및 예시 프롬프트

라이센스 요약
• "Show me our GitHub Enterprise license summary"
• "How many licenses are we currently using?"
자세한 라이센스 사용
• "List all consumed GitHub licenses"
• "Do we have any unused GitHub licenses?"
사용자 조회
• "What GitHub orgs does johndoe belong to?"
• "What enterprise roles does johndoe have?"
• "Is johndoe an owner in our enterprise?"
• "Get detailed info about johndoe"
• "Does johndoe have 2FA enabled?"

🌟 특징

라이선스 분석 : 총 좌석 수 대비 사용된 좌석 수
사용자 조회 : 조직 멤버십, 역할, 2FA, SAML ID
페이지 매김 : 대규모 기업을 자동으로 처리합니다
이중 전송 : 직접 MCP용 stdio, HTTP용 SSE
Kubernetes 지원 : EKS/GKE 또는 모든 K8s 클러스터에 배포 가능

📋 필수 조건

파이썬 3.9 이상
read:enterprise /라이선스 범위가 있는 GitHub PAT
GitHub Enterprise Cloud 테넌트

🚀 빠른 시작

1. 복제 및 설치

지엑스피1

2. 구성

cp .env.example .env
# Edit .env: set GITHUB_TOKEN and GITHUB_ENTERPRISE_URL

3. 실행

stdio 전송

export TRANSPORT=stdio
python main.py

SSE 운송

export TRANSPORT=sse PORT=8050
python main.py

🐳 도커 & n8n

n8n과 함께 docker-compose.yml에 이 서비스를 추가하세요:

services:
  github-mcp:
    image: ghcr.io/vipink1203/mcp-github-enterprise:latest
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_ENTERPRISE_URL=${GITHUB_ENTERPRISE_URL}
      - TRANSPORT=sse
      - PORT=8050
    ports:
      - "8050:8050"
    restart: unless-stopped
    networks:
      - n8n-network

n8n의 UI에서 MCP 클라이언트를 활성화합니다.

설정 → 자격 증명 → 새 자격 증명
MCP 클라이언트 API를 선택하고 URL을 http://github-mcp:8050/sse 로 설정합니다.

🔌 클라이언트 구성

클로드 데스크탑 / 윈드서핑 / 커서

Claude Desktop 설정에 다음 구성을 추가하세요.

{
  "mcpServers": {
   "github-ent": {
     "command": "/path/to/your/venv/python",
     "args": ["/path/to/main.py"],
     "env": {
       "GITHUB_TOKEN": "",
       "GITHUB_ENTERPRISE_URL": "https://api.github.com/enterprises/{enterprise_name}",
       "TRANSPORT": "stdio"
     }
   }
}

SSE 구성

{
  "mcpServers": {
    "github": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

📊 예시 사용 사례

엔터프라이즈 사용자 관리 : 사용자 온보딩 및 오프보딩 자동화
라이센스 모니터링 : 라이센스 만료가 가까워지면 알림을 받으세요
조직 분석 : 조직 구조 및 관계 분석
사용자 액세스 감사 : 사용자 권한 및 액세스 수준 추적
AI 기반 GitHub Insights : AI가 기업의 GitHub 데이터를 분석하도록 하세요

🔌 MCP 도구 및 리소스

도구

이름	설명
`list_consumed_licenses`	라이센스를 요약하고 선택적으로 사용자를 포함합니다.
`get_user_organizations`	사용자의 GitHub 조직 멤버십 나열
`get_user_enterprise_roles`	사용자의 엔터프라이즈 역할 나열
`get_user_detail`	사용자에 대한 전체 라이센스 세부 정보

자원

URI	설명
`github://consumed-licenses/{dummy}`	전체 라이선스 사용 + 사용자 세부 정보
`github://user/{username}/roles`	사용자의 조직 및 엔터프라이즈 역할

🔒 보안 고려 사항

GitHub 토큰을 안전하게 저장하세요
GitHub 토큰에 적합한 범위를 사용하세요
생산을 위해 AWS Secrets Manager 또는 유사한 것을 사용하는 것을 고려하세요.
Kubernetes 배포에서 네트워크 정책 구현

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

📜 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

Python SDK를 위한 모델 컨텍스트 프로토콜
훌륭한 템플릿 구조를 제공하는 MCP-Mem0
포괄적인 API를 위한 GitHub API

❤️로 구축되어 AI ↔️ GitHub Enterprise와 원활하게 통합됩니다.

GitHub MCP Bridge

Integrations