Gitlab MCP Server

GitLab MCP Server

AI アシスタント向けの GitLab のすべて。 GitLab の REST API と GraphQL API を通じて、Free から Ultimate まで、GitLab.com でも最大 1,103 件のアクションを実行できます。Claude、Cursor、VS Code、Codex など、あらゆる MCP クライアントで動作する自己完結型バイナリです。自然な言葉で依頼すれば、GitLab の作業を実行します。

起動時のコンテキストはデフォルトで 11,396 トークンで、GitLab のどのプランでも同じです（GITLAB_MCP_CAPABILITY_SURFACE=minimal では 1,994 トークン）。 2 つのツールでカタログ全体にアクセスできます。各ツールを個別に列挙する方式では、577,678〜737,573 トークンが必要です。cl100k_base トークナイザーで測定し、CI で検証しています。測定方法

「マージリクエスト !15 をレビューして、マージしても安全か確認してください」 · 「最後のパイプラインが失敗した理由は何ですか？」 · 「自分に割り当てられている未解決のイシューを一覧表示してください」 · 「v1.0 から v2.0 までのリリースノートを作成してください」

このサーバーを選ぶ理由

• あらゆるプランとインスタンスに対応。 Free／CE、Premium、Ultimate、セルフマネージド、または Orbit ナレッジグラフを備えた GitLab.com に対応します。プランを検出し、それに応じてカタログが切り替わります。
• すでにお持ちのトークンを利用。 api スコープを持つ個人、プロジェクト、またはグループのアクセストークン、GitLab がそのトークンで許可するアクションには read_api、許可範囲からアクションごとに判定される細粒度トークン、HTTP モードでは OAuth を利用できます。各アクションに必要なスコープと細粒度の権限は、ツールリファレンスの項目に記載されています。
• 安全策を備えています。 読み取り専用モード、安全モード（書き込みの代わりに各書き込み操作のプレビューを表示）、名前によるツールの除外、破壊的な操作を行う前の確認に対応しています。
• 3 つの利用形態、2 つのトランスポート。 デフォルトでは 2 つの検出ツールを提供し、ドメインごとまたはアクションごとに 1 つのツールを用意します。デスクトップクライアントには stdio、各認証情報を分離して管理する共有デプロイには HTTP を利用できます。さらに、45 個のリソースと 37 個のプロンプトも備えています。
• 検証可能なリリース。 署名済みチェックサム、バイナリごとの SBOM、すべてのアーティファクトのビルド来歴を提供します。

インストール

ボタンを使うと Docker イメージが登録されるため、Docker が必要です。Claude Desktop の行では、代わりにネイティブ拡張機能がダウンロードされます。api スコープ（または GitLab がそのトークンで許可するアクションには read_api）を持つ個人アクセストークンを作成してください。書き込みを一切許可しない場合は、GITLAB_MCP_READ_ONLY=true を追加します。

クライアント	ワンクリックボタン	トークンの手順
VS Code		入力を求められます（マスク表示）
Cursor		YOUR_GITLAB_TOKENを編集
LM Studio		YOUR_GITLAB_TOKENを編集
Kiro		YOUR_GITLAB_TOKENを編集
Claude Desktop		設定 UI

Claude Code。 登録コマンドにトークンが含まれることはありません。-e GITLAB_TOKENは、Claude Codeがdockerに渡す環境変数からトークンを引き継ぎます。

export GITLAB_TOKEN=glpat-xxxx
claude mcp add gitlab --transport stdio \
  -- docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest

その他のクライアントでは、GITLAB_TOKENを渡す環境変数に設定し、次のいずれかをサーバーのコマンドとして実行します。

npx -y @jmrp.io/gitlab-mcp-server                   # npm, nothing installed first
uvx jmrplens-gitlab-mcp-server                      # PyPI, nothing installed first
dnx gitlab-mcp-server                               # NuGet (.NET 10 SDK), nothing installed first
brew install jmrplens/tap/gitlab-mcp-server         # Homebrew, macOS and Linux
winget install --id jmrplens.gitlab-mcp-server -e   # winget, Windows
docker run -i --rm -e GITLAB_TOKEN ghcr.io/jmrplens/gitlab-mcp-server:latest

セルフマネージドインスタンスでは、トークンの隣に GITLAB_URL=https://gitlab.example.com を設定します。Docker イメージを使用する場合は、コンテナーが指定された変数のみを受け取るため、docker の引数に -e GITLAB_URL を追加して転送する必要があります（Docker のインストール）。すべての接続方法、クライアントごとの設定、検証手順についてはインストールガイドをご覧ください。また、インストールを代行するアシスタントも、同じ内容を llms.txt で確認できます。

まず試してみる場合は、https://mcp.jmrp.io/gitlab で公開インスタンスが稼働しており、ブラウザーインスペクターから OAuth にサインインすると、読み取り専用で呼び出せます。トークンとすべてのリクエストはこのマシンを経由するため、継続して利用するには、ご自身で実行してください。ホスト型エンドポイントのページでは、サービスの内容と対象外の内容を説明しています。

ドキュメント

その他の情報はすべて、英語とスペイン語で docs.jmrp.io/gitlab-mcp-server に掲載されています。はじめに、設定、ツールの機能、HTTP サーバーモード、セキュリティ、プライバシー、トラブルシューティングをご覧ください。

貢献、セキュリティ、ライセンス

GitHub での貢献を歓迎します。CONTRIBUTING.md にワークフローが記載されており、CODE_OF_CONDUCT.md が適用されます。脆弱性は、SECURITY.md の説明に従って非公開で報告してください。サーバーは MIT ライセンスで提供されています（LICENSE）。

---

José M. Requena Plens がメンテナンスしています · プロジェクトページ · ホスト型インスタンス：mcp.jmrp.io/gitlab