GitHub MCP 서버 🚀

Node.js와 TypeScript로 구축된 커스텀 Model Context Protocol (MCP) 서버입니다. 이 서버를 사용하면 MCP 호환 AI 어시스턴트(Gemini Code Assist, Claude Desktop, Roo Code 등)가 GitHub 계정과 직접 상호작용할 수 있습니다.

✨ 기능 (사용 가능한 도구)

이 서버는 AI 어시스턴트에게 7가지 강력한 도구를 제공합니다:

1. create_repository: 새 공개 또는 비공개 저장소를 생성합니다.

2. get_my_repositories: 인증된 사용자의 가장 최근에 업데이트된 저장소 목록을 표시합니다.

3. get_repository: 특정 저장소의 세부 정보를 가져옵니다.

4. get_file_content: 코드 분석을 위해 저장소 내 모든 파일의 정확한 내용을 읽습니다.

5. search_code: 저장소 전체에서 함수, 키워드 또는 구문을 검색합니다.

6. create_issue: 특정 저장소에 새 이슈를 엽니다.

7. list_issues: 저장소의 열린 이슈를 확인합니다.

🛠️ 설치 및 설정

1. 저장소를 클론합니다:

   git clone [https://github.com/YOUR_USERNAME/mcp-github-server.git](https://github.com/YOUR_USERNAME/mcp-github-server.git)
   cd mcp-github-server
   Install dependencies:

Bash npm install 프로젝트를 빌드합니다:

Bash npm run build

🔑 GitHub 토큰을 얻는 방법

이 서버가 사용자를 대신하여 작업을 수행하도록 하려면 GitHub의 Personal Access Token (PAT)이 필요합니다.

GitHub 계정 설정으로 이동합니다.

Developer settings(왼쪽 사이드바 하단)로 이동합니다.

Personal access tokens -> Tokens (classic)을 클릭합니다.

Generate new token (classic)을 클릭합니다.

토큰에 메모를 추가합니다(예: "MCP Server").

필요한 범위(Scopes):

repo 상자를 체크합니다(이 옵션은 비공개 저장소에 대한 전체 제어 권한을 부여하며, 저장소 생성, 파일 읽기, 이슈 관리를 위해 필요합니다).

아래로 스크롤하여 Generate token을 클릭합니다.

토큰을 즉시 복사합니다(ghp_...로 시작합니다).

환경 설정 이 프로젝트의 루트 디렉토리에 .env 파일을 생성합니다:

Bash touch .env .env 파일에 토큰을 추가합니다:

مقتطف الرمز GITHUB_TOKEN=your_generated_token_here 🔌 IDE / AI 클라이언트에 연결하기 이 서버를 MCP를 지원하는 IDE 또는 확장 프로그램에서 사용하려면, 클라이언트의 MCP 설정(일반적으로 mcp.json 또는 mcp_config.json 파일)에서 빌드된 index.js 파일을 가리키도록 구성해야 합니다.

구성 예시:

JSON { "mcpServers": { "github-mcp": { "command": "node", "args": [ "--no-warnings", "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js" ], "env": { "GITHUB_TOKEN": "your_generated_token_here" } } } }

참고: ABSOLUTE_PATH_TO_YOUR_PROJECT를 사용자 컴퓨터의 실제 경로로 반드시 교체하세요.

🤝 기여하기 이 프로젝트는 작은 교육용 프로젝트입니다! 더 많은 도구(예: 풀 리퀘스트 관리, 커밋 읽기)를 추가하고 싶다면 저장소를 포크하고 Pull Request를 제출해 주세요.