Mrconfluencelinker MCP Server

🚀 GitLab PR 分析 MCP 服务器プロジェクトドキュメント

GitLab PR 分析 MCP サーバーは、GitLab 上のマージリクエスト（Pull Requests）を自動的に処理するツールです。このツールは Confluence と統合でき、開発活動の記録と共有を支援します。

🚀 クイックスタート

GitLab PR 分析 MCP サーバーを使用するには、まず必要な依存関係をインストールし、環境を設定してからサーバーを起動する必要があります。以下に詳細な手順を説明します。

✨ 主な機能

• マージリクエスト詳細の取得：GitLab から詳細なマージリクエスト情報を取得します。
• コード変更の分析：マージリクエスト内のコード変更を詳細に分析します。
• レポートの生成：基本的なマージリクエスト情報、コード統計、ファイルタイプ分析などの詳細レポートを生成します。
• Confluence との統合：分析結果を Confluence に保存し、チームの協力と共有を容易にします。

📦 インストール

方法一：pip を使用した依存関係のインストール

pip install -r requirements.txt

方法二：uv を使用した依存関係の管理

uv add

📚 ドキュメント

設定説明

1. .env.example をプロジェクトのルートディレクトリにコピーし、.env という名前に変更します。
2. .env ファイルを編集し、以下の環境変数を入力します。
   • GITLAB_URL: GitLab インスタンスの URL
   • GITLAB_TOKEN: GitLab API アクセストークン
   • CONFLUENCE_URL: Confluence インスタンスの URL（オプション）
   • CONFLUENCE_TOKEN: Confluence API アクセストークン（オプション）

サーバーの起動

方法一：server.py を直接実行

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

方法二：Claude Desktop を通じて設定して起動

Claude Desktop で uv.json に以下の設定を追加します。

{
  "name": "gitlab-pr-analysis",
  "path": "/path/to/your/project/src/MRConfluenceLinker-mcp-server/server.py"
}

ツール説明

1. マージリクエスト詳細の取得（fetch_mr_details）

• 機能：GitLab から指定されたプロジェクトのマージリクエストの詳細情報を取得します。
• パラメータ：
  • project_id: 取得するプロジェクトの ID
  • mr_id: 取得するマージリクエストの ID

2. コード変更の分析（analyze_code_changes）

• 機能：マージリクエスト内のコード変更を分析し、詳細な変更レポートを生成します。
• パラメータ：
  • project_id: 分析するプロジェクトの ID
  • mr_id: 分析するマージリクエストの ID

3. Confluence への保存（store_in_confluence）

• 機能：マージリクエストの詳細情報と分析結果を Confluence に保存します。
• パラメータ：
  • project_id: 保存するプロジェクトの ID
  • mr_id: 保存するマージリクエストの ID

ログ記録

サーバーが実行されると、mcp_server.log ファイルにログが生成され、デバッグや問題の解決に役立ちます。

エラー処理

このプロジェクトには、以下のようなさまざまなエラー処理メカニズムが組み込まれています。

• 認証失敗：環境変数が正しく設定されているかを確認します。
• ネットワーク問題：API アクセス権限と URL が有効かを確認します。
• その他の例外：mcp_server.log ログファイルを参照して詳細情報を取得します。

貢献ガイド

1. プロジェクトリポジトリを Fork します。
2. 機能ブランチを作成します。
3. コードの変更をコミットします。
4. Pull Request を提出します。

プロジェクト構造

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                    # プロジェクト説明
└── requirements.txt             # 依存関係管理ファイル

連絡先

何か問題や提案がある場合は、プロジェクトのメンテナに連絡してください。

📄 ライセンス

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