mcp-github

Lume용 GitHub MCP 서버 — Lume 마켓플레이스 최초의 비내장 플러그인으로, 타사 플러그인 흐름을 종단 간 검증하는 데 사용됩니다.

v1에서는 읽기 전용입니다. 어시스턴트가 사용자의 개인 액세스 토큰으로 볼 수 있는 범위 내에서 GitHub 저장소, 이슈, 풀 리퀘스트, 커밋 및 파일 내용을 사용자를 대신하여 검색하고 읽을 수 있습니다.

도구 (읽기 전용 v1)

Related MCP server: GitHub Read MCP Server

인증

사용자별 모델: API 프로세스는 각 호출 시 JSON X-PA-Credentials 헤더를 주입하며, 이 서버는 해당 헤더에서 github_token을 읽습니다. 헤더가 없는 경우에만 GITHUB_TOKEN 환경 변수로 대체됩니다(부트스트랩 관리자).

Lume 사용자로 구성하는 방법:

1. https://github.com/settings/tokens에서 개인 액세스 토큰을 생성합니다. Fine-grained 또는 classic 토큰 모두 가능하며, 읽기 전용 범위(repo:read, read:org 등)면 충분합니다.

2. Lume → 설정 → 플러그인 → GitHub에 토큰을 붙여넣습니다. 서버는 암호화된 자격 증명 저장소를 통해 모든 도구 호출 시 토큰을 검색합니다.

실행

이 플러그인은 PA-iOS docker-compose 스택의 사이드카로 실행되도록 설계되었습니다. 설치 방법:

1. PA-iOS 클론 옆에 이 저장소를 클론합니다:

   git clone https://github.com/bryarpatch36/mcp-github.git

2. compose.fragment.yml 스니펫을 PA-iOS/docker-compose.yml에 병합합니다.

3. docker compose up -d --build mcp-github를 실행합니다.

4. 설정 → 플러그인 → 탐색에서 Lume에 플러그인을 설치합니다.

매니페스트

Lume 플러그인 매니페스트는 manifest.json에 있으며, Lume의 마켓플레이스 카탈로그가 https://raw.githubusercontent.com/bryarpatch36/mcp-github/main/manifest.json에서 가져옵니다.

로드맵

• v1.0 — 읽기 전용 (이번 릴리스)

• v1.1 — Lume의 2단계 확인 프로토콜을 통한 이슈 및 PR 댓글 작성

• v1.2 — 확인 절차를 통한 이슈 및 PR 생성

• 포크, 브랜치, 병합은 명시적으로 범위에서 제외됩니다. 이러한 작업은 LLM 도구 호출이 아닌 실제 셸에서 실행되어야 합니다.

라이선스

MIT