@hicho-lge/gerrit-mcp/README.md

Gerrit Code Review system을 위한 Model Context Protocol (MCP) 서버 - 23개 도구로 변경사항, 프로젝트, 계정 관리 기능 제공

# 🚀 Gerrit MCP Server

[![npm version](https://badge.fury.io/js/gerrit-mcp.svg)](https://badge.fury.io/js/gerrit-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D16.0.0-brightgreen)](https://nodejs.org/)

Gerrit Code Review 시스템과 상호작용하기 위한 Model Context Protocol (MCP) 서버입니다.

VS Code에서 Gerrit을 직접 제어할 수 있습니다!

## ✨ 주요 기능 (23개 도구)

### 🔗 연결 관리
- `gerrit_connect` - Gerrit 서버 연결
- `gerrit_test_connection` - 연결 상태 테스트

### 📝 변경사항 관리 (7개)
- `gerrit_query_changes` - 변경사항 검색
- `gerrit_get_change` - 변경사항 상세 조회
- `gerrit_review_change` - 리뷰 작성
- `gerrit_abandon_change` - 변경사항 포기
- `gerrit_get_change_comments` - 댓글 조회
- `gerrit_reply_to_inline_comment` - 인라인 답글
- `gerrit_get_change_fetch_info` - Git fetch 정보

### 📁 프로젝트 관리 (8개)
- `gerrit_list_projects` - 프로젝트 목록
- `gerrit_get_project` - 프로젝트 정보
- `gerrit_get_project_description` - 프로젝트 설명
- `gerrit_get_project_head` - HEAD 브랜치
- `gerrit_list_project_branches` - 브랜치 목록
- `gerrit_list_project_tags` - 태그 목록
- `gerrit_list_access_rights` - 접근 권한
- `gerrit_get_project_clone_info` - 클론 정보

### 👥 계정 관리 (2개)
- `gerrit_query_accounts` - 사용자 검색
- `gerrit_get_account` - 계정 정보

### 📄 파일 작업 (2개)
- `gerrit_list_files` - 파일 목록
- `gerrit_get_content` - 파일 내용

### 🔍 커밋 작업 (2개)
- `gerrit_get_commit` - 커밋 정보
- `gerrit_get_included_in` - 포함된 브랜치/태그

## ⚙️ VS Code 연동 설정

VS Code의 MCP 설정 파일에 다음을 추가하세요:

```json
{
  "mcpServers": {
    "gerrit-review": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gerrit-mcp@latest"
      ],
      "env": {
        "GERRIT_BASE_URL": "https://your-gerrit-server.com",
        "GERRIT_USERNAME": "your-username",
        "GERRIT_HTTP_CREDENTIALS": "your-http-password"
      },
      "description": "Gerrit Code Review MCP Server"
    }
  }
}
```

### 환경변수 설정

```bash
export GERRIT_BASE_URL="https://your-gerrit-server.com"
export GERRIT_USERNAME="your-username"
export GERRIT_HTTP_CREDENTIALS="your-http-password"
```

## ⭐ 검증 완료

✅ **Gerrit 3.1.8에서 테스트 완료**
✅ **23개 도구 모두 정상 동작 확인**
✅ **실제 운영 환경 데이터 처리 검증**
✅ **프로덕션 준비 완료**

## 🌐 호환성

- **Gerrit**: 3.1.8+
- **Node.js**: 16+
- **MCP SDK**: 0.5.0+

## 📝 라이선스

MIT License - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.