Codebywaqas MRConfluenceLinker MCP Server

🚀 GitLab PR 分析 MCP サーバー

このプロジェクトは、GitLab のマージリクエスト分析と Confluence ドキュメントを統合する MCP（モデル制御プロトコル）サーバーを提供します。このサーバーを使用すると、マージリクエストの詳細情報を取得し、コードの変更を分析し、結果を Confluence ページに保存することができます。

✨ 主な機能

• GitLab のマージリクエストの詳細情報を取得する
• マージリクエスト内のコード変更を分析する
• 詳細なレポートを生成する。内容は以下の通り：
  • 基本的なマージリクエスト情報
  • コード変更の統計情報
  • ファイルタイプ分析
  • 詳細なファイル変更
• 分析結果を Confluence に保存する
• デバッグ用の全面的なログ記録

📦 インストール

前提条件

• Python 3.8 以上
• API アクセス権を持つ GitLab アカウント
• Confluence アカウント（分析結果を保存する場合に必要）
• 必要な GitLab プロジェクトへのアクセス権

インストール手順

1. リポジトリをクローンします：

git https://github.com/CodeByWaqas/MRConfluenceLinker-mcp-server.git
cd MRConfluenceLinker-mcp-server

2. 仮想環境を作成してアクティブ化します：

python -m venv .venv
source .venv/bin/activate  # Windows の場合は、.venv\Scripts\activate を使用

3. 依存関係をインストールします：

pip install -r requirements.txt

または

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

📚 ドキュメント

設定

config.py ファイルを作成し、以下の内容を追加します：

# config.py
from mcp_server import resources

resources.initialize()

使用方法

1. サーバーを起動します：

uvicorn --reload mcp_server.server:app

2. ドキュメントにアクセスします：デフォルトブラウザで http://localhost:8000/docs を開きます。

3. API エンドポイントを使用します：

   • /api/v1/prs：すべてのマージリクエストを取得します。
   • /api/v1/pr/{pr_id}：特定のマージリクエストの詳細情報を取得します。

プロジェクト構造

MRConfluenceLinker-mcp-server/
├── src/                           # ソースコードディレクトリ
│   └── 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                     # 依存関係のロックファイル

主要コンポーネント

• ソースコード：src/mcp_server/ ディレクトリにあります。

  • server.py：主要な MCP サーバーの実装。
  • resources/client.py：クライアントの実装で、GitLab PR 統合を含みます。

• 設定ファイル：

  • requirements.txt：Python パッケージの依存関係。
  • pyproject.toml：プロジェクトのメタデータとビルド設定。
  • uv.lock：ロックされた依存関係のバージョン。
  • .env.example：環境変数のテンプレート。

📄 ライセンス

このプロジェクトのライセンスについては、LICENSE ファイルを参照してください。