GitHub 저장소 분석기 MCP 서버

대규모 언어 모델(LML)이 GitHub 저장소를 실시간으로 분석할 수 있도록 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 저장소 정보 검색, 문제 분석, 문서 접근 및 활동 시각화를 위한 도구를 제공합니다.

특징

• 저장소 정보 도구 : GitHub 저장소에 대한 기본 메타데이터 검색
• 이슈 분석 도구 : 저장소 이슈를 나열하고 분류합니다.
• README 액세스 리소스 : 액세스 저장소 문서
• 커밋 기록 도구 : 최근 코드 변경 사항 분석
• 활동 분석 도구 : 저장소 활동 지표 계산
• 시각화 도구 : 저장소 활동의 시각적 차트 만들기

필수 조건

• Python 3.10 이상
• GitHub 계정 및 개인 액세스 토큰

설치

1. 이 저장소를 복제하세요:

지엑스피1

2. 가상 환경을 만들고 활성화하세요.

3. 종속성 설치:

4. GitHub API 토큰으로 .env 파일을 만듭니다.

.env 파일을 편집하여 your_github_token_here 실제 GitHub 개인 액세스 토큰으로 바꾸세요.

용법

서버 실행

MCP Inspector를 사용하여 개발 모드로 서버를 시작하려면:

브라우저에서 웹 인터페이스가 열리고, 거기서 서버 도구를 테스트할 수 있습니다.

Claude Desktop에 등록

Claude Desktop에 서버를 등록하려면:

등록 후 Claude Desktop을 다시 시작하세요. 그러면 Claude에게 GitHub 저장소에 대해 질문하여 GitHub 저장소 분석기와 상호 작용할 수 있습니다.

클로드에 대한 예시 프롬프트

• "GitHub 저장소 'modelcontextprotocol/python-sdk'를 분석해 주시고, 그 목적과 활동 수준에 대해 알려주시겠습니까?"
• 'openai/openai-python' 저장소의 가장 큰 5개 미해결 이슈는 무엇인가요?
• "'anthropics/anthropic-sdk-python' 저장소는 지난 30일 동안 얼마나 활동적이었나요?"
• 'microsoft/TypeScript' 저장소의 README를 읽고 주요 기능에 대해 설명해 주세요.
• "지난 60일 동안 'facebook/react'에 대한 커밋 활동을 보여주는 차트를 생성합니다."

개발

프로젝트 구조

새로운 도구 추가

서버에 새로운 도구를 추가하려면 다음 단계를 따르세요.

1. github_tools.py 의 GitHubAPIClient 클래스에 필요한 기능을 추가합니다.
2. @server.tool 데코레이터를 사용하여 server.py 에 있는 MCP 서버에 도구를 등록합니다.
3. MCP Inspector를 사용하여 도구 테스트

테스트

서버를 테스트하려면 사용법 섹션에 설명된 대로 MCP Inspector를 사용하세요. GitHub API 클라이언트 기능에 대한 단위 테스트를 작성할 수도 있습니다.

보안 고려 사항

• GitHub API 토큰을 버전 제어에 커밋하지 마세요.
• GitHub 토큰에 필요한 최소 범위를 사용하세요.
• GitHub API 속도 제한을 주의하세요

특허

MIT 라이센스