Custom GitLab MCP Server

🚀 GitLab コードマージリクエストレビューロボット

このツールは、Anthropic の Claude モデルを統合した AI 動的 GitLab マージリクエストコードレビューツールです。自動化されたコードレビューとチェックリストのコンプライアンス評価を提供します。

🚀 クイックスタート

このツールは、Anthropic の Claude モデルを活用して、GitLab のマージリクエストに対する自動化されたコードレビューとチェックリスト評価を行います。以下の手順でセットアップして使用できます。

✨ 主な機能

• マージリクエストが開かれたり更新されたりすると自動的にコードレビューを行います。
• コードのスタイル、品質、セキュリティ問題およびベストプラクティスを分析します。
• チームの基準に基づいて、マージリクエストに対するカスタムチェックリスト評価を行います。
• 各ファイルに対する詳細なフィードバックを提供します。
• 全体的な評価を行い、最終的な提案（承認、軽微な修正後の承認、修正が必要）を提供します。
• GitLab の webhook で自動的にトリガーすることも、手動でトリガーすることもできます。
• Slack 通知を送信することができます（オプション）。

📦 インストール

前提条件

• Node.js (v14 またはそれ以上のバージョン)
• npm または yarn
• API アクセス権を持つ GitLab アカウント
• Anthropic Claude API キー

インストール手順

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

   git clone <repository-url>
   cd gitlab-mr-reviewer
   

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

   npm install
   

3. サンプル環境ファイルをコピーし、自分の設定に更新します：

   cp .env.example .env
   

   .env ファイルを編集し、GitLab と Claude の認証情報を関連する値に置き換えます。

📚 ドキュメント

設定

.env ファイルで以下の変数を更新します：

# GitLab 設定
GITLAB_API_URL=https://gitlab.example.com/api/v4
GITLAB_PRIVATE_TOKEN=your_private_token_here
GITLAB_WEBHOOK_SECRET=your_webhook_secret_here

# Anthropic Claude 設定
CLAUDE_API_KEY=your_claude_api_key_here
CLAUDE_MODEL=claude-3-opus-20240229

# アプリケーション設定
PORT=3000
NODE_ENV=development

# ログ記録設定
LOG_LEVEL=info

# Slack 通知（オプション）
SLACK_WEBHOOK_URL=your_slack_webhook_url_here

マージリクエストチェックリスト

このツールは、チームの基準に基づいて、各マージリクエストに対して以下のチェックを行います：

1. 変更の説明が明確かつ完全であること
2. Trello カードがリンクされていること
3. version.json のバージョン番号が増加していること
4. Trello カードに詳細な説明があること
5. 必要に応じて、proto ファイルが更新されていること
6. エラー処理（try-catch）が正しく実装され、適切な場所に Slack 通知が追加されていること
7. 関数の長さが 50 行を超えないこと（または説明があること）
8. マージリクエストが単一の目的（ロジックの変更またはリファクタリング）に焦点を当てていること
9. 単体テストが追加されていること
10. ドキュメントが更新されていること

これらのチェックは、src/services/claude.service.js の MR_CHECKLIST 定数で実装されており、必要に応じてカスタマイズすることができます。

貢献ガイド

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License オープンソースライセンスの下で提供されています。