Gitlab MCP

🚀 GitLab API ドキュメント

このドキュメントは、GitLab API を使用してプロジェクトの管理や操作を行うための詳細な情報を提供します。

🚀 クイックスタート

このセクションでは、GitLab API を使用した基本的な操作方法を紹介します。

✨ 主な機能

• プロジェクトの取得、作成
• グループ内のプロジェクトの取得
• プロジェクトのタグ管理
• 環境変数の設定

📦 インストール

この API を使用するには、以下の環境変数を設定する必要があります。

GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token
GITLAB_API_URL=your_gitlab_api_url  # デフォルト: https://gitlab.com/api/v4
GITLAB_READ_ONLY_MODE=true          # オプション: 読み取り専用モードを有効にする

💻 使用例

プロジェクトリスト

単一プロジェクトの取得

• エンドポイント: /projects/{project_id}
• メソッド: GET
• パラメータ:
  • include_subgroups: サブグループのプロジェクトを含めるかどうか。デフォルトはfalse
  • statistics: プロジェクトの統計情報を返すかどうか。選択肢: true または false

新しいプロジェクトの作成

• エンドポイント: /projects
• メソッド: POST
• リクエストボディ:

{
    "name": string,
    "description": string,
    "visibility": string,
    "namespace": string,
    "ssh_url": string,
    "http_url": string,
    "auto_clone": boolean
}

組織プロジェクトリスト

単一グループのプロジェクトの取得

• エンドポイント: /groups/{group_id}/projects
• メソッド: GET
• パラメータ:
  • include_subgroups: サブグループのプロジェクトを含めるかどうか。デフォルトはfalse
  • search: 検索キーワード。プロジェクト名または説明でフィルタリング
  • archived: アーカイブされたプロジェクトを含めるかどうか。デフォルトはfalse

タグ管理

プロジェクトのタグをリストする

• エンドポイント: /projects/{project_id}/labels
• メソッド: GET
• パラメータ:
  • with_counts: タグのIssueとマージリクエストの数を含めるかどうか。デフォルトはfalse
  • include_ancestor_groups: 祖先グループのタグを含めるかどうか。デフォルトはfalse

📄 ライセンス

MIT License