GitLab PR 분석 MCP 서버

이 프로젝트는 GitLab 병합 요청 분석과 Confluence 문서를 통합하는 MCP(모델 제어 프로토콜) 서버를 제공합니다. 이를 통해 병합 요청 세부 정보를 가져오고, 코드 변경 사항을 분석하고, 결과를 Confluence 페이지에 저장할 수 있습니다.

특징

GitLab에서 병합 요청 세부 정보 가져오기
병합 요청의 코드 변경 사항 분석
다음을 포함한 자세한 보고서를 생성합니다.
- 기본 병합 요청 정보
- 코드 변경 통계
- 파일 유형 분석
- 자세한 파일 변경 사항
Confluence에서 매장 분석 결과
디버깅을 위한 포괄적인 로깅

필수 조건

Python 3.8 이상
API 액세스가 가능한 GitLab 계정
Confluence 계정(선택 사항, 분석 결과 저장용)
필요한 GitLab 프로젝트에 대한 액세스

설치

저장소를 복제합니다.

지엑스피1

가상 환경을 만들고 활성화하세요.

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

종속성 설치:

pip install -r requirements.txt

또는

uv add "mcp[cli]" python-gitlab python-dotenv atlassian-python-api requests

구성

예제 환경 파일을 복사하세요.

cp .env.example .env

자격 증명으로 .env 파일을 편집합니다.

GITLAB_URL=https://gitlab.com
GITLAB_TOKEN=your_gitlab_token
GITLAB_PROJECT_ID=your_project_id

# Optional Confluence integration
CONFLUENCE_URL=your_confluence_url
CONFLUENCE_USERNAME=your_username
CONFLUENCE_TOKEN=your_confluence_token
CONFLUENCE_SPACE=your_space_key

자격 증명 취득

GitLab 토큰 : api 범위로 GitLab에서 개인 액세스 토큰 생성
Confluence 토큰 : Atlassian 계정 설정에서 API 토큰을 생성하세요

용법

MCP 서버를 시작합니다.

python src/MRConfluenceLinker-mcp-server/server.py

또는

Claude Desktop으로 설정

# claude_desktop_config.json
# Can find location through:
# Claude -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
      "MRConfluenceLinker-mcp-server": {
          "command": "uv",
          "args": [
              "--directory",
              "/<Absolute-path-to-folder>/MRConfluenceLinker-mcp-server/src/MRConfluenceLinker-mcp-server",
              "run",
              "server.py"
          ]
      }
  }
}

2. The server will listen for commands through stdin/stdout. You can interact with it using prompts like:

"my-project" 프로젝트의 병합 요청 #1에 대한 세부 정보를 가져올 수 있나요? "my-project" 프로젝트의 병합 요청 #1에서 코드 변경 사항을 분석할 수 있나요? "my-project" 프로젝트의 병합 요청 #1에 대한 요약을 Confluence에 저장할 수 있나요?

## Available Tools

The server provides the following tools:

1. `fetch_mr_details`: Fetches details of a specific merge request or all merge requests
   - Parameters:
     - `project_id`: The GitLab project ID
     - `mr_id` (optional): Specific merge request ID

2. `analyze_code_changes`: Analyzes code changes in a merge request
   - Parameters:
     - `project_id`: The GitLab project ID
     - `mr_id`: The merge request ID to analyze

3. `store_in_confluence`: Stores analysis results in Confluence
   - Parameters:
     - `project_id`: The GitLab project ID
     - `mr_id` (optional): Specific merge request ID
     - `analysis` (optional): Analysis results to store

## Logging

The server generates detailed logs in `mcp_server.log` and outputs to stderr. This helps in debugging issues with:
- GitLab API access
- Confluence integration
- Code analysis
- Page creation and updates

## Error Handling

The server includes comprehensive error handling for:
- Missing environment variables
- API authentication issues
- Network connectivity problems
- Invalid project or merge request IDs
- Confluence permission issues

## Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Support

For support, please [create an issue](https://github.com/CodeByWaqas/MRConfluenceLinker-mcp-server/issues) or contact the maintainers.

## Project Structure

MRConfluenceLinker-mcp-server/ ├── src/ # 소스 코드 디렉터리 │ └── MRConfluenceLinker-mcp-server/ # 메인 서버 패키지 │ ├── resources/ # 리소스 모듈 │ │ ├── init .py │ │ ├── client.py # 클라이언트 구현 / GitLab PR 통합 │ ├── server.py # 메인 서버 구현 │ └── mcp_server.log # 서버 로그 ├── pycache / # Python 캐시 파일 ├── .git/ # Git 저장소 ├── .gitignore # Git 무시 규칙 ├── CONTRIBUTING.md # 기여 지침 ├── LICENSE # 프로젝트 라이선스 ├── README.md # 프로젝트 문서 ├── pyproject.toml # Python 프로젝트 구성 ├── requirements.txt # 프로젝트 종속성 └── uv.lock # 종속성 잠금 파일

### Key Components

- **Source Code**: Located in the `src/MRConfluenceLinker-mcp-server/` directory
  - `server.py`: Main MCP server implementation
  - `resources/client.py`: Client-side implementation contains GitLab PR integration

- **Configuration Files**:
  - `requirements.txt`: Python package dependencies
  - `pyproject.toml`: Project metadata and build configuration
  - `uv.lock`: Locked dependency versions
  - `.env.example`: Environment variables template

- **Documentation**:
  - `README.md`: Project overview and setup instructions
  - `CONTRIBUTING.md`: Contribution guidelines
  - `LICENSE`: Project license

- **Development**:
  - `__pycache__/`: Python cache files
  - `mcp_server.log`: Server logs for debugging

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

GitLab 병합 요청 분석을 Confluence 문서와 통합하여 사용자가 병합 요청 세부 정보를 가져오고, 코드 변경 사항을 분석하고, Confluence 페이지에 분석 결과를 저장할 수 있습니다.

Related MCP Servers

PR Reviewer
KalyankumarKonduru
-
security
F
license
-
quality
A tool that integrates with GitHub and Notion to analyze and review pull requests, enabling automated code reviews and documentation in Notion.
Last updated -
GitLab MCP Server
amirsina-mandegari
-
security
F
license
-
quality
Connects AI assistants to GitLab, allowing users to manage merge requests, view reviews, and interact with discussions through natural language queries.
Last updated -
9
MCP GitLab Server
Vijay-Duke
A
security
A
license
A
quality
Enables comprehensive GitLab integration allowing LLMs to manage projects, issues, merge requests, repository files, CI/CD pipelines, and perform batch operations. Supports advanced features like AI-optimized summaries, smart diffs, and atomic operations with rollback support.
Last updated -
72
Apache 2.0
GitLab MCP Code Review
ffpy
-
security
A
license
-
quality
Enables AI assistants to review GitLab merge requests by fetching changes, analyzing diffs, adding comments, and managing approvals through the GitLab API. Supports complete merge request analysis, file-specific reviews, and version comparisons.
Last updated -
3
MIT License

View all related MCP servers

GitLab PR Analysis MCP Server

GitLab PR 분석 MCP 서버

특징

필수 조건

설치

구성

자격 증명 취득

용법

Claude Desktop으로 설정

Related MCP Servers

PR Reviewer

GitLab MCP Server

MCP GitLab Server

GitLab MCP Code Review

Appeared in Searches

New MCP Servers

MCP directory API