Repolode
投稿する
zereight

zereight/gitlab-mcp

AIアシスタントがGitLabのプロジェクト、マージリクエスト、Issue、パイプライン、Wikiなどを操作するための構造化ツールを提供するMCPサーバー。

GitHub で見る公式サイト
スター
2,089
フォーク
368
未解決の Issue
11
最終コミット
昨日

これは何？

gitlab-mcpは、Claude、Cursor、VS Code、CopilotなどのAIクライアントをGitLabインスタンスに接続するModel Context Protocolサーバーです。GitLab REST APIとGraphQL APIを利用し、プロジェクト、マージリクエスト、Issue、パイプライン、Wiki、リリース、タグ、マイルストーンなどを操作する約280個のツールを提供します。デフォルトでは約40個の必要最小限のツールだけを読み込み、セッション中に追加のツールセットを有効化できるため、モデルに渡すツール一覧を小さく保てます。

ローカルクライアント向けにはstdioで、共有環境やホスト環境でのデプロイにはStreamable HTTPまたはSSEで動作します。認証方式は、Personal Access Token、ローカルでのOAuth2ブラウザーフロー、リモートクライアント向けのMCP OAuthプロキシ、複数ユーザー環境向けのリクエストごとのトークン転送に対応しています。権限モード（readonly、modify、full）、ツールの許可・拒否フィルター、グループやプロジェクトの制限によって、エージェントが変更できる範囲を制御できます。

マージリクエストのレビューでは、まず変更ファイルを一覧表示し、その後、差分をまとめて取得する2段階のフローを採用しています。オプションのJMESPathフィルタリングと結果の圧縮により、大きなレスポンスを縮小できます。同じバイナリには、差分やジョブログなどの完全なペイロードを扱うCLIも用意されており、GitLab.comとセルフマネージドインスタンスの両方で動作します。

主な機能

  • 01プロジェクト、マージリクエスト、Issue、パイプライン、Wiki、リリース向けの約280個のツール
  • 02必要最小限のツールセットをデフォルトで読み込み、必要に応じて追加ツールを有効化
  • 03stdio、SSE、Streamable HTTPのトランスポート
  • 04Personal Access Token、OAuth2、リクエストごとのリモート認証に対応
  • 05ツールおよびプロジェクトのフィルターを備えたreadonly／modify権限モード
  • 06差分をまとめて取得する、2段階のマージリクエストレビュー

ユースケース

  • AIコーディングアシスタントに、マージリクエストの変更ファイルや差分をレビューさせる
  • エージェントにGitLabのパイプラインのジョブログを確認させたり、CIアクションを実行させたりする
  • ユーザーごとのトークンを使い、ホストされたGitLab MCPエンドポイントをチームで共有する
  • レポート作成やトリアージに、読み取り専用のGitLab連携を利用する

クイックスタート

  1. 1

    npm からバイナリをインストールする

    npm install -g @zereight/mcp-gitlab
  2. 2

    GitLab のパーソナルアクセストークンを設定する（入力内容は画面に表示されません）

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    Claude Code にサーバーを登録する

    claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab

使う前に知っておきたいこと

  • デフォルトのツールセットで公開されるツールは約 40 個のみです。その他のツールは discover_tools で有効化する必要があります。
  • api ツールセットは許可リストと安全性チェックを回避するため、リスクがあります。

収録されている特集

Claude Code 向け MCP サーバーClaude Code のツール・スキル・プラグインオープンソースの AI エージェント・フレームワークとアプリAI コーディングアシスタントとエージェントMCP サーバー

トピック

#mcp#gitlab#ai-agent#llm#code-review#devops#model-context-protocol#ai#claude#cursor

よくある質問

gitlab-mcp とは？
AIアシスタントがGitLabのプロジェクト、マージリクエスト、Issue、パイプライン、Wikiなどを操作するための構造化ツールを提供するMCPサーバー。 gitlab-mcpは、Claude、Cursor、VS Code、CopilotなどのAIクライアントをGitLabインスタンスに接続するModel Context Protocolサーバーです。GitLab REST APIとGraphQL APIを利用し、プロジェクト、マージリクエスト、Issue、パイプライン、Wiki、リリース、タグ、マイルストーンなどを操作する約280個のツールを提供します。デフォルトでは約40個の必要最小限のツールだけを読み込み、セッション中に追加のツールセットを有効化できるため、モデルに渡すツール一覧を小さく保てます。
gitlab-mcp は無料で使えますか？ライセンスは？
gitlab-mcp は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
gitlab-mcp は今もメンテナンスされていますか？
活発にメンテナンス中。gitlab-mcp の最終コミットは 2026年11月6日 です。
gitlab-mcp は何に使えますか？
AIコーディングアシスタントに、マージリクエストの変更ファイルや差分をレビューさせる エージェントにGitLabのパイプラインのジョブログを確認させたり、CIアクションを実行させたりする ユーザーごとのトークンを使い、ホストされたGitLab MCPエンドポイントをチームで共有する レポート作成やトリアージに、読み取り専用のGitLab連携を利用する
gitlab-mcp のインストール方法は？
npm からバイナリをインストールする: npm install -g @zereight/mcp-gitlab GitLab のパーソナルアクセストークンを設定する（入力内容は画面に表示されません）: read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Claude Code にサーバーを登録する: claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
gitlab-mcp はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/zereight/gitlab-mcp

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト