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?"

Related MCP server: GitHub MCP Server

🌟 특징

• 라이선스 분석 : 총 좌석 수 대비 사용된 좌석 수

• 사용자 조회 : 조직 멤버십, 역할, 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 도구 및 리소스

도구

자원

🔒 보안 고려 사항

• GitHub 토큰을 안전하게 저장하세요

• GitHub 토큰에 적합한 범위를 사용하세요

• 생산을 위해 AWS Secrets Manager 또는 유사한 것을 사용하는 것을 고려하세요.

• Kubernetes 배포에서 네트워크 정책 구현

🤝 기여하기

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

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기

📜 라이센스

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

🙏 감사의 말

• Python SDK를 위한 모델 컨텍스트 프로토콜

• 훌륭한 템플릿 구조를 제공하는 MCP-Mem0

• 포괄적인 API를 위한 GitHub API

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