remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
GitHub 프로젝트 관리자 MCP 서버
표준화된 도구와 리소스를 통해 GitHub 프로젝트 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 LLM 클라이언트는 MCP 인터페이스를 통해 GitHub 프로젝트를 프로그래밍 방식으로 관리할 수 있습니다.
개요
이 서버는 모델 컨텍스트 프로토콜(Model Context Protocol)을 구현하여 GitHub 프로젝트 기능을 LLM 클라이언트에 제공합니다. GitHub의 GraphQL API를 통해 프로젝트, 마일스톤, 스프린트 및 메트릭을 관리하는 동시에 MCP 사양에 따라 상태를 유지하고 오류를 처리하는 도구를 제공합니다.
주요 특징
- 프로젝트 관리
- GitHub 프로젝트 생성 및 관리(v2)
- 프로젝트 설정 및 구성 처리
- 프로젝트 가시성 및 액세스 관리
- 프로젝트 리소스
- 이슈 및 이정표 관리
- 스프린트 계획 및 추적
- 사용자 정의 필드 및 보기
- 리소스 버전 관리 및 잠금
- MCP 구현
- 전체 MCP 사양 준수
- Zod 검증을 통한 표준화된 도구 정의
- 리소스 상태 관리
- 점진적 대응 처리
- 포괄적인 오류 처리
- GitHub 통합
- 페이지네이션 지원을 통한 GraphQL API 통합
- 지능형 요금 제한 처리
- 낙관적 동시성
- 웹훅 지원(계획됨)
설치
지엑스피1
구성
필수 환경 변수:
GitHub 토큰에는 다음과 같은 권한이 필요합니다.
repo(전체 저장소 액세스)project(프로젝트 접근)write:org(조직 접근)
용법
자세한 사용 지침은 사용자 가이드를 참조하세요.
건축학
서버는 명확한 계층을 갖춘 클린 아키텍처 원칙을 따릅니다.
- 도메인 계층 : 핵심 엔티티, 저장소 인터페이스 및 Zod 스키마
- 인프라 계층 : GitHub API 통합 및 구현
- 서비스 계층 : 비즈니스 로직 조정
- MCP 계층 : 도구 정의 및 요청 처리
자세한 아키텍처 문서는 ARCHITECTURE.md를 참조하세요.
현재 상태
핵심 기능
| 특징 | 상태 | 노트 |
|---|---|---|
| 프로젝트 생성 | ✅ 완료 | v2 프로젝트에 대한 전체 지원 |
| 마일스톤 관리 | ✅ 완료 | CRUD 작업이 구현되었습니다. |
| 스프린트 계획 | ✅ 완료 | 메트릭 추적 포함 |
| 이슈 관리 | ✅ 완료 | 사용자 정의 필드 지원 |
| 리소스 버전 관리 | ✅ 완료 | 낙관적 잠금 및 스키마 검증을 통해 |
| 웹훅 통합 | 📅 계획됨 | 실시간 업데이트 |
MCP 구현
| 요소 | 상태 | 노트 |
|---|---|---|
| 도구 정의 | ✅ 완료 | Zod 검증을 통해 구현된 모든 핵심 도구 |
| 자원 관리 | ✅ 완료 | 낙관적 잠금 및 관계 추적 |
| 응답 처리 | ✅ 완료 | 다양한 콘텐츠 유형을 갖춘 풍부한 콘텐츠 형식 |
| 오류 처리 | ✅ 완료 | MCP 오류 코드에 대한 포괄적인 오류 매핑 |
| 국가 관리 | ✅ 완료 | 갈등 해결 및 속도 제한 |
최근 개선 사항
- 강화된 자원 시스템 :
- 모든 리소스 유형에 대한 Zod 스키마 검증이 추가되었습니다.
- 리소스 관계 추적을 구현했습니다.
- 일관된 리소스 액세스를 위해 중앙화된 ResourceFactory를 생성했습니다.
- 개선된 GitHub API 통합 :
- 자동 조절 기능이 있는 지능형 속도 제한 기능이 추가되었습니다.
- REST 및 GraphQL API에 대한 페이지 매김 지원 구현
- 특정 오류 유형을 통한 향상된 오류 처리
- 고급 도구 시스템 :
- Zod 검증을 통해 도구 정의 레지스트리를 생성했습니다.
- 표준화된 도구 응답 형식을 구현했습니다.
- 모든 도구에 대한 예제 기반 문서가 추가되었습니다.
- 풍부한 응답 형식 :
- 다양한 콘텐츠 유형(JSON, Markdown, HTML, 텍스트)에 대한 지원이 추가되었습니다.
- 장기 실행 작업에 대한 진행 상황 업데이트 구현
- 대용량 결과 집합에 대한 페이지 매김 지원이 추가되었습니다.
식별된 기능적 격차
최근 개선에도 불구하고 다음과 같은 기능적 격차가 여전히 존재하며 향후 개발을 위해 우선순위가 지정되었습니다.
- 지속적 캐싱 전략 :
- ResourceCache는 메모리 내 캐싱을 제공하지만 서버 재시작 시 지속성이 부족합니다.
- 다중 인스턴스 배포에 대한 분산 캐싱 없음
- 메모리 관리를 위한 캐시 제거 정책이 누락되었습니다.
- 실시간 이벤트 처리 :
- GitHub에서 실시간 업데이트를 위한 웹훅 통합이 없습니다.
- 클라이언트를 위한 이벤트 기반 구독 시스템이 없습니다.
- 스트리밍 업데이트에 대한 SSE(서버 전송 이벤트) 지원 부족
- 고급 GitHub 프로젝트 v2 기능 :
- 사용자 정의 필드 유형 및 유효성 검사에 대한 제한된 지원
- GitHub의 최신 Projects v2 필드 유형과의 통합이 불완전합니다.
- 자동화 규칙 관리가 누락되었습니다.
- 성능 최적화 :
- 관련 리소스에 대한 쿼리 일괄 처리 없음
- 자주 액세스하는 리소스에 대한 백그라운드 새로 고침이 누락되었습니다.
- 관련 리소스에 대한 불완전한 사전 페칭
- 데이터 시각화 및 보고 :
- 메트릭에 대한 내장 시각화 생성기가 없습니다.
- 보고서 생성 기능이 없습니다
- 제한된 시계열 데이터 분석
자세한 구현 상태는 docs/mcp/gaps-analysis.md를 참조하세요.
선적 서류 비치
개발
테스트
코드 품질
기여하다
개발 지침은 CONTRIBUTING.md를 참조하세요.
특허
This server cannot be installed
GitHub 프로젝트, 마일스톤, 작업 및 스프린트를 관리하는 포괄적인 도구를 제공합니다. 이 서버는 GitHub Projects V2와 긴밀하게 통합되어 자동화된 칸반 워크플로, 스프린트 계획 및 사용자 지정 필드 관리와 같은 기능을 제공합니다.