MCP GitHub 저장소 서버

GitHub 저장소 콘텐츠에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 AI 비서가 지정된 GitHub 저장소의 파일을 탐색하고 읽을 수 있습니다.

데모

Related MCP server: GitHub MCP Server

특징

자원

• URI를 통해 GitHub 저장소의 모든 파일에 액세스

• 저장소 콘텐츠 나열 및 디렉토리 탐색

• 지점별 파일 액세스 지원

• 파일 내용은 일반 텍스트로 제공됩니다.

리소스 URI

• 기본 URL 형식: https://api.github.com/repos/{owner}/{repo}/contents/{path}

• 파일과 디렉토리를 모두 지원합니다

• 파일은 text/plain MIME 유형으로 제공됩니다.

• 디렉토리는 application/x-directory MIME 유형으로 제공됩니다.

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

지엑스피1

개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

구성 위치

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-github-repo": {
      "command": "/path/to/mcp-server-github-repo/build/index.js"
    }
  }
}

API 구현

서버는 세 가지 주요 MCP 엔드포인트를 구현합니다.

1. ListResources - 저장소의 파일 및 디렉토리를 나열합니다.

2. ReadResource - 특정 파일의 내용을 검색합니다.

입증

서버는 인증을 위해 GitHub 개인 액세스 토큰을 사용합니다. 토큰에 저장소 콘텐츠에 액세스할 수 있는 적절한 권한이 있는지 확인하세요.

오류 처리

서버에는 다음에 대한 오류 처리가 포함되어 있습니다.

• 환경 변수가 없습니다

• GitHub API 오류

• 잘못된 경로(예: 디렉토리를 파일로 읽으려고 시도)

• 인증 실패

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 디버깅에는 MCP Inspector를 사용하세요.

npm run inspector

이렇게 하면 브라우저에서 디버깅 도구에 액세스할 수 있는 URL이 제공됩니다.

보안 참고 사항

• GitHub 개인 액세스 토큰을 안전하게 보호하세요

• 최소한의 필수 권한이 있는 토큰 사용을 고려하세요.

• 대규모 저장소에 액세스할 때 저장소 크기 제한을 알아두십시오.

특허

MIT