🚀 GitLab MR MCP

🚀 GitLab MR MCP

GitLab のマージリクエストやイシューを操作するための、Model Context Protocol（MCP）サーバーです。

📌 概要

このプロジェクトは、AI エージェントが GitLab リポジトリを操作できるようにする、Model Context Protocol（MCP）を使用したサーバーを実装しています。次のツールを提供します。

• 利用可能な GitLab プロジェクトの一覧表示
• マージリクエストの詳細とコメントの取得
• マージリクエストの差分の取得
• マージリクエストへのコメントの追加
• マージリクエストの差分に含まれるコードへの行単位のコメントの追加
• イシューの詳細の取得
• マージリクエストのタイトルと説明の設定

📦 インストール

⚡ Smithery を使用する

Smithery 経由で Claude Desktop に GitLab MR MCP を自動インストールするには：

npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\", \"gitlabMrMcpHost\": \"YOUR_GITLAB_HOST\"}"'

🛠️ 手動インストール

🔧 前提条件

• Node.js
• API アクセス権を持つ GitLab アクセストークン
• GitLab プロジェクト ID

📖 セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. MCP クライアントの設定に以下を追加します：

{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"],
      "env": {
        "MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
        "MR_MCP_GITLAB_HOST": "your_gitlab_host"
      }
    }
  }
}

🛠️ 利用可能なツール

• get_projects トークンでアクセスできる GitLab プロジェクトの一覧を取得します。

• list_open_merge_requests 指定したプロジェクトのすべてのオープン中のマージリクエストを一覧表示します。

• get_merge_request_details 特定のマージリクエストの詳細情報を取得します。

• get_merge_request_comments ディスカッションのノートや差分ノートを含む、特定のマージリクエストのコメントを取得します。

• add_merge_request_comment マージリクエストに一般的なコメントを追加します。

• add_merge_request_diff_comment マージリクエスト内のファイルの特定の行にコメントを追加します。

• get_merge_request_diff マージリクエストの差分を取得します。

• get_issue_details 特定のイシューの詳細情報を取得します。

• set_merge_request_title マージリクエストのタイトルを設定します

• set_merge_request_description マージリクエストの説明を設定します

🏗️ 開発

🔍 Inspector の実行

環境変数を設定します：

export MR_MCP_GITLAB_TOKEN=your_gitlab_token
export MR_MCP_GITLAB_HOST=your_gitlab_host

# Optional env vars to filter the projects the `get_projects` tool has access to:
# https://docs.gitlab.com/api/access_requests/#valid-access-levels
export MR_MCP_MIN_ACCESS_LEVEL=min_access_level
# Search term that should match the project path or name 
export MR_MCP_PROJECT_SEARCH_TERM=term 

MCP クライアントで使用する場合は、次のコマンドを実行できます：

npx -y @modelcontextprotocol/inspector npm start

🛠️ トラブルシューティング

権限の問題（403 Forbidden）が発生した場合は、以下を確認してください。

1. GitLab トークンに適切なスコープ（api、read_api）があること
2. トークンのユーザーがプロジェクトへの適切なアクセス権を持っていること
3. プロジェクト ID が正しいこと

📜 ライセンス

MIT

🤝 貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。