GitHub MCP Server

TypeScript로 작성된 맞춤형 MCP(Model Context Protocol) 서버로, Claude를 GitHub REST API에 연결합니다.

하는 일

Claude가 호출할 수 있는 6가지 도구(tools)를 제공합니다:

Related MCP server: remote-mcp-oauth-github

1. GitHub Personal Access Token 만들기

1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens로 이동합니다.

2. 필요한 최소 권한으로 토큰을 생성합니다:

   • Contents: Read (get_file_content용)

   • Issues: Read and write (list_issues/create_issue용)

   • Metadata: Read (항상 필수)

3. 생성된 토큰을 복사합니다(github_pat_...로 시작합니다).

보안 팁: 토큰을 리포지토리에 커밋하지 마세요. 환경 변수를 사용하세요.

2. 설치 및 빌드

npm install
npm run build

그러면 서버 실행 파일인 build/index.js가 생성됩니다(stdio로 통신하며, MCP 표준 프로토콜입니다).

3. 로컬 테스트 (선택 사항, Claude 없이)

export GITHUB_PERSONAL_ACCESS_TOKEN="seu_token_aqui"
npm start

stderr에 GitHub MCP server rodando via stdio.가 표시되면 정상 작동 중입니다. 도구를 대화형으로 테스트하려면 MCP Inspector를 사용하세요:

npx @modelcontextprotocol/inspector node build/index.js

4. Claude Desktop에 연결

Claude Desktop의 구성 파일을 편집하세요:

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

• Windows: %APPDATA%\Claude\claude_desktop_config.json

다음을 추가하세요:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/caminho/absoluto/para/github-mcp-server/build/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. GitHub 도구가 대화의 도구 아이콘(🔨)에 표시됩니다.

5. 다음 단계 (포트폴리오를 확장하고 강화할 아이디어)

• 작성 도구 추가: create_pull_request, merge_pull_request, create_branch

• per_page만 쓰는 대신 실제 페이지네이션(커서 기반) 추가

• Rate limiting 및 캐시 (GitHub는 인증된 요청을 시간당 5,000건으로 제한)

• Vitest/Jest로 자동화된 테스트

• 푸시마다 lint + 테스트 + 빌드를 실행하는 GitHub Actions 기반 CI

• npm 패키지로 게시 (npx github-mcp-server)

• 서버를 Docker 컨테이너화 (다른 DevOps 프로젝트와 연결하기 좋은 접점)

프로젝트 구조

github-mcp-server/
├── src/
│   └── index.ts      # lógica do servidor e definição das tools
├── build/             # gerado pelo `npm run build`
├── package.json
├── tsconfig.json
└── README.md