高度なGitLab MCPサーバー

高度なGitLab MCPサーバー — CQRSアーキテクチャ、OAuth 2.1、および複数のトランスポートモードを備え、18のエンティティタイプにわたる44のツールを提供します。

クイックスタート

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@structured-world/gitlab-mcp"],
      "env": {
        "GITLAB_TOKEN": "your_gitlab_token",
        "GITLAB_API_URL": "https://gitlab.com"
      }
    }
  }
}

要件: Node.js >= 24

Related MCP server: GitLab MCP Server

ハイライト

• 44のツール — プロジェクト、マージリクエスト、パイプライン、ワークアイテム、Wikiなど、18のエンティティタイプに対応

• CQRSアーキテクチャ — クエリには browse_*、コマンドには manage_* を使用

• 接続の回復力 — 制限付き起動、指数バックオフによる自動再接続、GitLabに到達できない場合の切断モード

• マルチインスタンスサポート — インスタンスごとのOAuthとレート制限を使用して、複数のGitLabインスタンスに接続可能

• 複数のトランスポート — stdio、SSE、StreamableHTTP

• OAuth 2.1 — Claudeカスタムコネクタを介したユーザーごとの認証

• 読み取り専用モード — 本番環境での安全な運用

• 自動検出 — GitリモートからGitLab設定を検出

• きめ細かな制御 — ツールグループの有効化/無効化、アクションのフィルタリング、説明のカスタマイズ

• Dockerサポート — ghcr.io/structured-world/gitlab-mcp:latest

ドキュメント

完全なドキュメントは gitlab-mcp.sw.foundation で公開されています

自動生成されたツールリファレンス

パラメータを含む完全なツールリファレンスについては以下を参照してください：

# View locally
yarn list-tools --detail

# Generate documentation
yarn list-tools --export --toc > docs/tools/api-reference.md

自動生成されたツールドキュメントについては、完全なAPIリファレンスを参照してください。

Docker

# HTTP mode
docker run -e PORT=3002 -e GITLAB_TOKEN=your_token -p 3333:3002 \
  ghcr.io/structured-world/gitlab-mcp:latest

# stdio mode
docker run -i --rm -e GITLAB_TOKEN=your_token \
  ghcr.io/structured-world/gitlab-mcp:latest

接続の回復力

サーバーはGitLabの接続問題を適切に処理します：

• 制限付き起動 — GitLabの可用性に関係なく、サーバーは GITLAB_INIT_TIMEOUT_MS（デフォルト5秒）以内に起動します

• 切断モード — GitLabに到達できない場合（disconnected/failed状態）、manage_contextツールのみが公開され、診断用に whoami、switch_profile、set_scope などのローカルアクションが利用可能です。アクティブな再接続中（connecting状態）は、短い停止中にMCPクライアントがツールカタログを失わないよう、ツールリスト全体が引き続き利用可能です。MCPクライアントには tools/list_changed を介してツールの可用性の変更が通知されます

• 自動再接続 — ±10%のジッターを伴う指数バックオフ再接続（5秒 →