git-graph-mcp

로컬 우선(local-irst) Git 커밋 그래프 미널 도구로, 표준 MCP stdio 서비스도 함께 제곱합니다. 사욉자가 터미널에서 커밋이나 범위를 선태한 뒤 Claued Code, Codx, Cusor 등 MCP 클라이언트가 동일한 예산 제약이 적욉된 Git 컨텍스트를 읽을 수 있게 해줍니다.

기능

• 미널에서 커밋 그래프, 브랜치, 커밋 상세 정보 및 작업 영역 상태를 확인합니다.

• commit, range, ref 선택을 저장하고 CLI/TUI/MCP 간에 재사용합니다.

• MCP를 통해 graph, status, context, search, diff, history 및 resources를 읽습니다.

• 안전한 브랜치 작업과 reset 미리보기를 생성하며 reset/checkout/push를 자동으로 실행하지 않습니다.

• doctor를 사용해 Node.js, Git, 저장소, MCP 구성 및 stdio 핸드셰이크를 검사합니다.

Related MCP server: org-as-code MCP Server

빠른 시작

요구 사항: PATH에 Git이 있으며 Node.js 22+를 공식 지원합니다.

npm ci
node .\bin\git-graph-mcp.js graph --plain --limit 8
node .\bin\git-graph-mcp.js doctor

대화형 TUI:

node .\bin\git-graph-mcp.js graph

일반적인 작업:

node .\bin\git-graph-mcp.js status
node .\bin\git-graph-mcp.js search --limit 20
node .\bin\git-graph-mcp.js select commit <commit-oid>
node .\bin\git-graph-mcp.js selected
node .\bin\git-graph-mcp.js doctor --json

대상 저장소가 현재 디렉터리가 아니면 명령에 --repo <path>를 추가하세요.

MCP 구성

저장소 루트의 .mcp.json은 로컬 stdio를 사용합니다:

{
  "mcpServers": {
    "git-graph": {
      "type": "stdio",
      "command": "node",
      "args": ["./bin/git-graph-mcp.js", "mcp"]
    }
  }
}

서버는 12개의 제한된 도구와 두 개의 읽기 전용 resources를 제공합니다: git-graph://default/selection, git-graph://default/status. MCP stdout에는 프로토콜 메시지만 유지되며, 진단 정보는 stderr로 기록되고 저장소 경로, 구성 값, 요청 내용은 노출되지 않습니다.

보안 경계

기본 워크플로는 읽기 전용입니다. 브랜치 생성은 명시적 호출이 필요하며 기존 브랜치를 이동하지 않습니다. reset은 미리보기만 생성하고, git_revalidate_plan은 실행 전에 저장소 상태 지문을 검증합니다. 프로젝트는 네트워크 리스너를 시작하지 않으며 저장소 콘텐츠를 업로드하지 않습니다.

개발 및 릴리스

npm run check
npm run test:package-install

더 보기:

• 5분 데모

• 기능 및 테스트 증거

• 기여 가이드

• 보안 정책

• 릴리스 체크리스트