github-mcp-server

GitHub API를 조회하는 MCP 서버. FastMCP 기반으로 구현되었으며 uvx로 바로 실행할 수 있다.

이 저장소의 FastMCP 구현 패턴은 .claude/skills/fastmcp-server.md에 정리되어 있다.

도구

도구	설명
get_repo_info	저장소 기본 정보 (이름, 설명, 스타, 포크, 이슈 수)
list_open_prs	열린 Pull Request 목록 (최대 20개)
get_latest_release	최신 릴리즈 정보 (태그, 이름, 본문, 날짜)

설치 및 실행

uvx (권장)

GITHUB_TOKEN=your_token uvx github-mcp-server

로컬 개발

uv sync
GITHUB_TOKEN=your_token uv run python server.py

환경변수

변수	필수	설명
GITHUB_TOKEN	권장	GitHub Personal Access Token. 없으면 공개 저장소만 조회 가능하며 API 요청 제한이 낮아짐

.env 파일에 작성하면 자동으로 로드된다:

GITHUB_TOKEN=ghp_xxxxxxxxxxxx

MCP 클라이언트 연결

팀원용 (GitHub 저장소에서 직접 설치)

.mcp.json.team에 정의되어 있다. 사용하려면 프로젝트 루트에 복사하고 GITHUB_TOKEN을 설정한다:

cp .mcp.json.team .mcp.json
export GITHUB_TOKEN=your_token

{
  "mcpServers": {
    "github-tools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/myorg/github-mcp-server",
        "github-mcp-server"
      ],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

로컬 개발용 (이 저장소를 직접 수정하는 경우)

프로젝트 루트 .mcp.json에 아래처럼 로컬 소스를 직접 실행하도록 설정한다. .mcp.json은 Claude Code가 프로젝트 루트에서만 자동으로 인식하므로 다른 경로(.claude/ 등)에 두면 로드되지 않는다.

{
  "mcpServers": {
    "github-tools": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/github-mcp-server"
    }
  }
}