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
Provides access to GitHub repository contents, allowing browsing and reading files from specified repositories, navigating directories, and supporting branch-specific file access.
MCP GitHub 저장소 서버
GitHub 저장소 콘텐츠에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 AI 비서가 지정된 GitHub 저장소의 파일을 탐색하고 읽을 수 있습니다.
데모
특징
자원
- URI를 통해 GitHub 저장소의 모든 파일에 액세스
- 저장소 콘텐츠 나열 및 디렉토리 탐색
- 지점별 파일 액세스 지원
- 파일 내용은 일반 텍스트로 제공됩니다.
리소스 URI
- 기본 URL 형식:
https://api.github.com/repos/{owner}/{repo}/contents/{path} - 파일과 디렉토리를 모두 지원합니다
- 파일은
text/plainMIME 유형으로 제공됩니다. - 디렉토리는
application/x-directoryMIME 유형으로 제공됩니다.
구성
서버에는 다음과 같은 환경 변수가 필요합니다.
지엑스피1
개발
종속성 설치:
서버를 빌드하세요:
자동 재빌드를 사용한 개발의 경우:
설치
Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.
구성 위치
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 윈도우:
%APPDATA%/Claude/claude_desktop_config.json
API 구현
서버는 세 가지 주요 MCP 엔드포인트를 구현합니다.
ListResources- 저장소의 파일 및 디렉토리를 나열합니다.ReadResource- 특정 파일의 내용을 검색합니다.
입증
서버는 인증을 위해 GitHub 개인 액세스 토큰을 사용합니다. 토큰에 저장소 콘텐츠에 액세스할 수 있는 적절한 권한이 있는지 확인하세요.
오류 처리
서버에는 다음에 대한 오류 처리가 포함되어 있습니다.
- 환경 변수가 없습니다
- GitHub API 오류
- 잘못된 경로(예: 디렉토리를 파일로 읽으려고 시도)
- 인증 실패
디버깅
MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 디버깅에는 MCP Inspector를 사용하세요.
이렇게 하면 브라우저에서 디버깅 도구에 액세스할 수 있는 URL이 제공됩니다.
보안 참고 사항
- GitHub 개인 액세스 토큰을 안전하게 보호하세요
- 최소한의 필수 권한이 있는 토큰 사용을 고려하세요.
- 대규모 저장소에 액세스할 때 저장소 크기 제한을 알아두십시오.
특허
MIT
This server cannot be installed
AI 어시스턴트가 지정된 GitHub 저장소에서 파일을 탐색하고 읽을 수 있도록 해주는 서버로, 모델 컨텍스트 프로토콜을 통해 저장소 콘텐츠에 대한 액세스를 제공합니다.