Mooring — Git & GitHub MCP 서버

License: MIT

코드의 계류 라인(Mooring lines) — AI 도구를 위한 Git 및 GitHub 작업.

Mooring은 AI 어시스턴트에게 로컬 Git 저장소 및 GitHub API에 대한 구조화된 액세스를 제공하는 MCP 서버입니다. 로컬 작업은 GitPython을 사용하며(하위 프로세스 호출 없음), GitHub 작업은 토큰 마스킹 및 속도 제한 처리가 내장된 PyGithub 라이브러리를 사용합니다.

도구

로컬 Git

도구	설명	주요 매개변수
`repo_status`	브랜치, 앞서감/뒤처짐, 스태시 개수, 스테이징/언스테이징/추적되지 않은 파일	`repo_path`
`repo_log`	선택적 필터가 포함된 커밋 로그	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	통합 diff — 작업 트리, 스테이징 또는 참조 간 비교	`repo_path`, `staged`, `from_ref`, `to_ref`
`repo_blame`	선택적 라인 범위가 포함된 Git blame	`repo_path`, `file_path`, `start_line`, `end_line`
`repo_branches`	추적 정보, 마지막 커밋, 앞서감/뒤처짐을 포함한 모든 브랜치	`repo_path`
`repo_stash`	스태시 작업: 목록, 푸시, 팝, 적용	`repo_path`, `action`, `message`

GitHub

도구	설명	주요 매개변수
`gh_pr_list`	풀 리퀘스트 목록	`repo`, `state`, `author`, `label`
`gh_pr_detail`	리뷰, 댓글 및 체크 실행을 포함한 PR 상세 정보	`repo`, `number`
`gh_pr_create`	풀 리퀘스트 생성	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	이슈 목록, 생성 또는 업데이트	`repo`, `state`, `action`, `title`, `body`, `number`
`gh_actions`	최근 GitHub Actions 워크플로우 실행 목록	`repo`, `workflow`, `status`

유틸리티

도구	설명	주요 매개변수
`health`	서버 버전 및 상태 확인	(없음)

설치

# PyPI
pip install mooring-mcp

# Isolated install
pipx install mooring-mcp

사용법

서버를 직접 실행:

mooring

Claude Code

claude mcp add mooring -- mooring

Claude Desktop

Claude Desktop 설정(claude_desktop_config.json)에 추가:

{
  "mcpServers": {
    "mooring": {
      "command": "mooring",
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token"
      }
    }
  }
}

모든 GitHub 도구(gh_*)를 사용하려면 GITHUB_TOKEN 환경 변수가 필요합니다. 로컬 Git 도구는 토큰 없이도 작동합니다.

보안

경로 탐색 보호 — 파일 경로는 작업 전에 저장소 루트를 기준으로 확인 및 검증됩니다.
심볼릭 링크 탈출 탐지 — 저장소 외부를 가리키는 심볼릭 링크는 거부됩니다.
참조(Ref) 검증 — Git 참조는 안전한 문자 패턴을 기준으로 확인되며 사용 전 존재 여부가 검증됩니다.
토큰 마스킹 — 오류 메시지는 반환되기 전에 GitHub 토큰 패턴(ghp_*, gho_*, github_pat_*)에 대해 스크러빙됩니다.
속도 제한 처리 — GitHub 403 응답은 원시 예외 대신 명확한 메시지로 포착되어 표시됩니다.

개발

git clone https://github.com/seayniclabs/mooring.git
cd mooring
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q