@wanadev/mcp-gitlab 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wanadev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @wanadev/mcp-gitlab
+
+Serveur MCP (Model Context Protocol) pour gerer les **epics**, **issues** et **milestones** GitLab depuis Claude Desktop ou tout client MCP compatible.
+
+## Installation rapide
+
+### Prerequis
+
+- **Node.js >= 20**
+- Un **Personal Access Token** (PAT) GitLab avec le scope `api` (ou `read_api` pour lecture seule)
+- **GitLab Premium/Ultimate** pour les epics (issues et milestones fonctionnent avec toutes les editions)
+
+### 1. Generer un token GitLab
+
+1. Aller dans **GitLab > Settings > Access Tokens**
+2. Creer un token avec le scope `api`
+3. Copier le token
+
+### 2. Configurer Claude Desktop
+
+Ajouter dans votre fichier `claude_desktop_config.json` :
+
+**Windows :** `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS :** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "gitlab": {
+      "command": "npx",
+      "args": ["-y", "@wanadev/mcp-gitlab"],
+      "env": {
+        "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
+        "GITLAB_BASE_URL": "https://gitlab.com",
+        "GITLAB_READ_ONLY": "false"
+      }
+    }
+  }
+}
+```
+
+### 3. Redemarrer Claude Desktop
+
+Le serveur MCP sera disponible immediatement. Testez avec : *"Liste mes groupes GitLab"*
+
+## Variables d'environnement
+
+| Variable | Requis | Description |
+|----------|--------|-------------|
+| `GITLAB_TOKEN` | Oui | Personal Access Token GitLab |
+| `GITLAB_BASE_URL` | Non | URL de l'instance GitLab (defaut: `https://gitlab.com`) |
+| `GITLAB_READ_ONLY` | Non | `true` pour bloquer toutes les operations d'ecriture |
+
+> **Note :** Le `group_id` n'est plus une variable d'environnement. Chaque tool group-scoped prend un parametre `group_id` requis. Utilisez `list_groups` pour decouvrir les groupes accessibles.
+
+## Mode dry-run (confirmation avant ecriture)
+
+Tous les tools d'ecriture (`create_*`, `update_*`, `close_*`, `add_issue_to_epic`) ont un parametre `dry_run` qui vaut **`true` par defaut**.
+
+- **`dry_run: true`** (defaut) — retourne un resume de l'action prevue sans rien executer sur GitLab.
+- **`dry_run: false`** — execute reellement l'action apres confirmation de l'utilisateur.
+
+Cela evite toute modification accidentelle : le LLM montre d'abord ce qu'il va faire, et n'execute qu'apres votre accord.
+
+## Les 19 tools disponibles
+
+### Epics (necessite GitLab Premium/Ultimate)
+
+| Tool | Description | `group_id` requis | dry_run |
+|------|-------------|:---:|:---:|
+| `list_epics` | Lister les epics (filtre par etat, recherche, labels) | Oui | — |
+| `get_epic` | Details d'un epic par numero | Oui | — |
+| `create_epic` | Creer un epic | Oui | Oui |
+| `update_epic` | Modifier un epic | Oui | Oui |
+| `close_epic` | Fermer un epic | Oui | Oui |
+| `list_epic_issues` | Issues rattachees a un epic | Oui | — |
+| `add_issue_to_epic` | Rattacher une issue a un epic | Oui | Oui |
+
+### Issues
+
+| Tool | Description | `group_id` requis | dry_run |
+|------|-------------|:---:|:---:|
+| `list_issues` | Lister les issues d'un groupe | Oui | — |
+| `get_issue` | Details d'une issue (project-scoped) | Non | — |
+| `create_issue` | Creer une issue (project-scoped) | Non | Oui |
+| `update_issue` | Modifier une issue (project-scoped) | Non | Oui |
+| `close_issue` | Fermer une issue (project-scoped) | Non | Oui |
+
+### Milestones
+
+| Tool | Description | `group_id` requis | dry_run |
+|------|-------------|:---:|:---:|
+| `list_milestones` | Lister les milestones d'un groupe | Oui | — |
+| `get_milestone` | Details d'un milestone | Oui | — |
+| `create_milestone` | Creer un milestone | Oui | Oui |
+
+### Utilitaires
+
+| Tool | Description | `group_id` requis | dry_run |
+|------|-------------|:---:|:---:|
+| `list_groups` | Decouvrir les groupes accessibles | Non | — |
+| `list_projects` | Lister les projets d'un groupe | Oui | — |
+| `list_group_members` | Lister les membres d'un groupe | Oui | — |
+| `get_current_user` | Verifier la connexion (info utilisateur) | Non | — |
+
+## Exemples de prompts
+
+- *"Liste mes groupes GitLab"*
+- *"Liste les epics ouverts du groupe 42"*
+- *"Montre-moi les issues avec le label bug dans le groupe wanadev"*
+- *"Cree un epic 'Refonte homepage' dans le groupe 42 avec une echeance au 30 avril"*
+- *"Quelles issues sont dans l'epic #42 du groupe wanadev ?"*
+- *"Ferme l'issue #15 du projet 789"*
+- *"Qui sont les membres du groupe wanadev ?"*
+
+## Developpement
+
+```bash
+git clone https://github.com/wanadev/gitlab-mcp.git
+cd gitlab-mcp
+npm install
+npm run build       # Build ESM (tsc)
+npm run typecheck   # Verification TypeScript
+npm run dev         # Build en mode watch
+```
+
+## Notes
+
+- **`issue_id` vs `issue_iid`** : pour `add_issue_to_epic`, il faut l'ID global de l'issue (pas le numero affiche dans le projet). Les outils `list_issues` et `list_epic_issues` affichent les deux.
+- **Mode lecture seule** : avec `GITLAB_READ_ONLY=true`, toute tentative de creation/modification retourne une erreur claire.
+- **Erreur 403 sur les epics** : necessite une licence GitLab Premium ou Ultimate.

package/dist/client.d.ts

@@ -0,0 +1,128 @@
+import type { GitLabConfig, GitLabEpic, GitLabIssue, GitLabMilestone, GitLabUser, GitLabProject, GitLabMember, GitLabGroup, GitLabMergeRequest, GitLabLabel, GitLabNote, GitLabBoard, GitLabIteration } from "./types.js";
+export declare class GitLabClient {
+    private baseUrl;
+    private token;
+    private readOnly;
+    constructor(config: GitLabConfig);
+    private request;
+    private formatHttpError;
+    paginate<T>(path: string, params?: Record<string, string>): Promise<T[]>;
+    listGroups(params?: {
+        search?: string;
+        top_level_only?: boolean;
+    }): Promise<GitLabGroup[]>;
+    listEpics(groupId: string, params?: {
+        state?: string;
+        search?: string;
+        labels?: string;
+        order_by?: string;
+        sort?: string;
+    }): Promise<GitLabEpic[]>;
+    getEpic(groupId: string, epicIid: number): Promise<GitLabEpic>;
+    createEpic(groupId: string, data: {
+        title: string;
+        description?: string;
+        labels?: string;
+        start_date?: string;
+        due_date?: string;
+    }): Promise<GitLabEpic>;
+    updateEpic(groupId: string, epicIid: number, data: {
+        title?: string;
+        description?: string;
+        labels?: string;
+        start_date?: string;
+        due_date?: string;
+        state_event?: string;
+    }): Promise<GitLabEpic>;
+    closeEpic(groupId: string, epicIid: number): Promise<GitLabEpic>;
+    listEpicIssues(groupId: string, epicIid: number): Promise<GitLabIssue[]>;
+    addIssueToEpic(groupId: string, epicIid: number, issueId: number): Promise<{
+        id: number;
+        epic: GitLabEpic;
+        issue: GitLabIssue;
+    }>;
+    listEpicNotes(groupId: string, epicIid: number): Promise<GitLabNote[]>;
+    addEpicNote(groupId: string, epicIid: number, body: string): Promise<GitLabNote>;
+    listGroupIssues(groupId: string, params?: {
+        state?: string;
+        search?: string;
+        labels?: string;
+        milestone?: string;
+        assignee_username?: string;
+        order_by?: string;
+        sort?: string;
+    }): Promise<GitLabIssue[]>;
+    getIssue(projectId: number, issueIid: number): Promise<GitLabIssue>;
+    createIssue(projectId: number, data: {
+        title: string;
+        description?: string;
+        labels?: string;
+        milestone_id?: number;
+        assignee_ids?: number[];
+        due_date?: string;
+        weight?: number;
+        epic_id?: number;
+        iteration_id?: number;
+    }): Promise<GitLabIssue>;
+    updateIssue(projectId: number, issueIid: number, data: {
+        title?: string;
+        description?: string;
+        labels?: string;
+        milestone_id?: number;
+        assignee_ids?: number[];
+        due_date?: string;
+        weight?: number;
+        state_event?: string;
+        iteration_id?: number;
+    }): Promise<GitLabIssue>;
+    closeIssue(projectId: number, issueIid: number): Promise<GitLabIssue>;
+    listIssueNotes(projectId: number, issueIid: number): Promise<GitLabNote[]>;
+    addIssueNote(projectId: number, issueIid: number, body: string): Promise<GitLabNote>;
+    listGroupMergeRequests(groupId: string, params?: {
+        state?: string;
+        search?: string;
+        labels?: string;
+        milestone?: string;
+        author_username?: string;
+        reviewer_username?: string;
+        order_by?: string;
+        sort?: string;
+    }): Promise<GitLabMergeRequest[]>;
+    getMergeRequest(projectId: number, mrIid: number): Promise<GitLabMergeRequest>;
+    listGroupMilestones(groupId: string, params?: {
+        state?: string;
+        search?: string;
+    }): Promise<GitLabMilestone[]>;
+    getMilestone(groupId: string, milestoneId: number): Promise<GitLabMilestone>;
+    createMilestone(groupId: string, data: {
+        title: string;
+        description?: string;
+        start_date?: string;
+        due_date?: string;
+    }): Promise<GitLabMilestone>;
+    updateMilestone(groupId: string, milestoneId: number, data: {
+        title?: string;
+        description?: string;
+        start_date?: string;
+        due_date?: string;
+        state_event?: string;
+    }): Promise<GitLabMilestone>;
+    closeMilestone(groupId: string, milestoneId: number): Promise<GitLabMilestone>;
+    listGroupIterations(groupId: string, params?: {
+        state?: string;
+        search?: string;
+    }): Promise<GitLabIteration[]>;
+    listProjects(groupId: string, params?: {
+        search?: string;
+        archived?: string;
+    }): Promise<GitLabProject[]>;
+    listGroupMembers(groupId: string, params?: {
+        search?: string;
+    }): Promise<GitLabMember[]>;
+    listGroupLabels(groupId: string, params?: {
+        search?: string;
+    }): Promise<GitLabLabel[]>;
+    listGroupBoards(groupId: string): Promise<GitLabBoard[]>;
+    getCurrentUser(): Promise<GitLabUser>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAU;gBAEd,MAAM,EAAE,YAAY;YAMlB,OAAO;IAsErB,OAAO,CAAC,eAAe;IAyBjB,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,CAAC,EAAE,CAAC;IA+CT,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAUpB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcnB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAO9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,UAAU,CAAC;IAQjB,UAAU,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,UAAU,CAAC;IAQhB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIhE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMxE,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAO1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMtE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAUhF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiBpB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOnE,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,WAAW,CAAC;IAQjB,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,WAAW,CAAC;IAQjB,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;IAIjB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAUpF,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QACrD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAiB3B,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS9E,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAWxB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5E,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAC3C,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQtB,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,CAAC;IAQrB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAaxB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWtB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUrB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAUpB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMxD,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;CAG5C"}

package/dist/client.js

@@ -0,0 +1,288 @@
+export class GitLabClient {
+    baseUrl;
+    token;
+    readOnly;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.token = config.token;
+        this.readOnly = config.readOnly;
+    }
+    async request(method, path, body) {
+        if (this.readOnly && method !== "GET") {
+            throw new Error(`Mode lecture seule actif (GITLAB_READ_ONLY=true). Impossible d'effectuer une requete ${method}.`);
+        }
+        const url = new URL(`/api/v4${path}`, this.baseUrl);
+        let lastError = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const response = await fetch(url.toString(), {
+                    method,
+                    headers: {
+                        "PRIVATE-TOKEN": this.token,
+                        "Content-Type": "application/json",
+                    },
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: AbortSignal.timeout(15_000),
+                });
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get("Retry-After");
+                    const delay = retryAfter
+                        ? parseInt(retryAfter, 10) * 1000
+                        : 1000 * 2 ** attempt;
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                    continue;
+                }
+                if (!response.ok) {
+                    const text = await response.text().catch(() => "");
+                    const message = this.formatHttpError(response.status, text, path);
+                    throw new Error(message);
+                }
+                if (response.status === 204) {
+                    return undefined;
+                }
+                return (await response.json());
+            }
+            catch (error) {
+                if (error instanceof Error &&
+                    error.message.startsWith("Mode lecture seule")) {
+                    throw error;
+                }
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (error instanceof DOMException &&
+                    error.name === "TimeoutError") {
+                    if (attempt < 2)
+                        continue;
+                }
+                else if (!(error instanceof Error && error.message.includes("429"))) {
+                    throw lastError;
+                }
+            }
+        }
+        throw lastError ?? new Error("Echec apres 3 tentatives");
+    }
+    formatHttpError(status, body, path) {
+        let detail = "";
+        try {
+            const parsed = JSON.parse(body);
+            detail = parsed.message ?? parsed.error ?? body;
+        }
+        catch {
+            detail = body;
+        }
+        switch (status) {
+            case 401:
+                return "Authentification echouee. Verifiez votre GITLAB_TOKEN.";
+            case 403:
+                return `Acces refuse (403) sur ${path}. Verifiez les permissions du token et le niveau GitLab (Premium/Ultimate pour les epics).`;
+            case 404:
+                return `Ressource introuvable (404) : ${path}. Verifiez l'ID du groupe/projet.`;
+            default:
+                return `Erreur GitLab ${status} sur ${path}: ${detail}`;
+        }
+    }
+    async paginate(path, params) {
+        const results = [];
+        let page = 1;
+        const maxItems = 500;
+        while (results.length < maxItems) {
+            const url = new URL(`/api/v4${path}`, this.baseUrl);
+            url.searchParams.set("per_page", "100");
+            url.searchParams.set("page", String(page));
+            if (params) {
+                for (const [key, value] of Object.entries(params)) {
+                    if (value !== undefined && value !== "") {
+                        url.searchParams.set(key, value);
+                    }
+                }
+            }
+            const response = await fetch(url.toString(), {
+                method: "GET",
+                headers: {
+                    "PRIVATE-TOKEN": this.token,
+                    "Content-Type": "application/json",
+                },
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => "");
+                throw new Error(this.formatHttpError(response.status, text, path));
+            }
+            const data = (await response.json());
+            if (data.length === 0)
+                break;
+            results.push(...data);
+            const totalPages = response.headers.get("X-Total-Pages");
+            if (totalPages && page >= parseInt(totalPages, 10))
+                break;
+            page++;
+        }
+        return results.slice(0, maxItems);
+    }
+    // --- Groups ---
+    async listGroups(params) {
+        const queryParams = {};
+        if (params?.search)
+            queryParams["search"] = params.search;
+        if (params?.top_level_only)
+            queryParams["top_level_only"] = "true";
+        return this.paginate("/groups", queryParams);
+    }
+    // --- Epics ---
+    async listEpics(groupId, params) {
+        const queryParams = {};
+        if (params?.state)
+            queryParams["state"] = params.state;
+        if (params?.search)
+            queryParams["search"] = params.search;
+        if (params?.labels)
+            queryParams["labels"] = params.labels;
+        if (params?.order_by)
+            queryParams["order_by"] = params.order_by;
+        if (params?.sort)
+            queryParams["sort"] = params.sort;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/epics`, queryParams);
+    }
+    async getEpic(groupId, epicIid) {
+        return this.request("GET", `/groups/${encodeURIComponent(groupId)}/epics/${epicIid}`);
+    }
+    async createEpic(groupId, data) {
+        return this.request("POST", `/groups/${encodeURIComponent(groupId)}/epics`, data);
+    }
+    async updateEpic(groupId, epicIid, data) {
+        return this.request("PUT", `/groups/${encodeURIComponent(groupId)}/epics/${epicIid}`, data);
+    }
+    async closeEpic(groupId, epicIid) {
+        return this.updateEpic(groupId, epicIid, { state_event: "close" });
+    }
+    async listEpicIssues(groupId, epicIid) {
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/epics/${epicIid}/issues`);
+    }
+    async addIssueToEpic(groupId, epicIid, issueId) {
+        return this.request("POST", `/groups/${encodeURIComponent(groupId)}/epics/${epicIid}/issues/${issueId}`);
+    }
+    async listEpicNotes(groupId, epicIid) {
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/epics/${epicIid}/notes`);
+    }
+    async addEpicNote(groupId, epicIid, body) {
+        return this.request("POST", `/groups/${encodeURIComponent(groupId)}/epics/${epicIid}/notes`, { body });
+    }
+    // --- Issues ---
+    async listGroupIssues(groupId, params) {
+        const queryParams = {};
+        if (params?.state)
+            queryParams["state"] = params.state;
+        if (params?.search)
+            queryParams["search"] = params.search;
+        if (params?.labels)
+            queryParams["labels"] = params.labels;
+        if (params?.milestone)
+            queryParams["milestone"] = params.milestone;
+        if (params?.assignee_username)
+            queryParams["assignee_username"] = params.assignee_username;
+        if (params?.order_by)
+            queryParams["order_by"] = params.order_by;
+        if (params?.sort)
+            queryParams["sort"] = params.sort;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/issues`, queryParams);
+    }
+    async getIssue(projectId, issueIid) {
+        return this.request("GET", `/projects/${projectId}/issues/${issueIid}`);
+    }
+    async createIssue(projectId, data) {
+        return this.request("POST", `/projects/${projectId}/issues`, data);
+    }
+    async updateIssue(projectId, issueIid, data) {
+        return this.request("PUT", `/projects/${projectId}/issues/${issueIid}`, data);
+    }
+    async closeIssue(projectId, issueIid) {
+        return this.updateIssue(projectId, issueIid, { state_event: "close" });
+    }
+    async listIssueNotes(projectId, issueIid) {
+        return this.paginate(`/projects/${projectId}/issues/${issueIid}/notes`);
+    }
+    async addIssueNote(projectId, issueIid, body) {
+        return this.request("POST", `/projects/${projectId}/issues/${issueIid}/notes`, { body });
+    }
+    // --- Merge Requests ---
+    async listGroupMergeRequests(groupId, params) {
+        const queryParams = {};
+        if (params?.state)
+            queryParams["state"] = params.state;
+        if (params?.search)
+            queryParams["search"] = params.search;
+        if (params?.labels)
+            queryParams["labels"] = params.labels;
+        if (params?.milestone)
+            queryParams["milestone"] = params.milestone;
+        if (params?.author_username)
+            queryParams["author_username"] = params.author_username;
+        if (params?.reviewer_username)
+            queryParams["reviewer_username"] = params.reviewer_username;
+        if (params?.order_by)
+            queryParams["order_by"] = params.order_by;
+        if (params?.sort)
+            queryParams["sort"] = params.sort;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/merge_requests`, queryParams);
+    }
+    async getMergeRequest(projectId, mrIid) {
+        return this.request("GET", `/projects/${projectId}/merge_requests/${mrIid}`);
+    }
+    // --- Milestones ---
+    async listGroupMilestones(groupId, params) {
+        const queryParams = {};
+        if (params?.state)
+            queryParams["state"] = params.state;
+        if (params?.search)
+            queryParams["search"] = params.search;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/milestones`, queryParams);
+    }
+    async getMilestone(groupId, milestoneId) {
+        return this.request("GET", `/groups/${encodeURIComponent(groupId)}/milestones/${milestoneId}`);
+    }
+    async createMilestone(groupId, data) {
+        return this.request("POST", `/groups/${encodeURIComponent(groupId)}/milestones`, data);
+    }
+    async updateMilestone(groupId, milestoneId, data) {
+        return this.request("PUT", `/groups/${encodeURIComponent(groupId)}/milestones/${milestoneId}`, data);
+    }
+    async closeMilestone(groupId, milestoneId) {
+        return this.updateMilestone(groupId, milestoneId, { state_event: "close" });
+    }
+    // --- Iterations ---
+    async listGroupIterations(groupId, params) {
+        const queryParams = {};
+        if (params?.state)
+            queryParams["state"] = params.state;
+        if (params?.search)
+            queryParams["search"] = params.search;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/iterations`, queryParams);
+    }
+    // --- Utils ---
+    async listProjects(groupId, params) {
+        const queryParams = {};
+        if (params?.search)
+            queryParams["search"] = params.search;
+        if (params?.archived)
+            queryParams["archived"] = params.archived;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/projects`, queryParams);
+    }
+    async listGroupMembers(groupId, params) {
+        const queryParams = {};
+        if (params?.search)
+            queryParams["search"] = params.search;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/members`, queryParams);
+    }
+    async listGroupLabels(groupId, params) {
+        const queryParams = {};
+        if (params?.search)
+            queryParams["search"] = params.search;
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/labels`, queryParams);
+    }
+    async listGroupBoards(groupId) {
+        return this.paginate(`/groups/${encodeURIComponent(groupId)}/boards`);
+    }
+    async getCurrentUser() {
+        return this.request("GET", "/user");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GitLabClient } from "./client.js";
+import { registerEpicTools } from "./tools/epics.js";
+import { registerIssueTools } from "./tools/issues.js";
+import { registerMilestoneTools } from "./tools/milestones.js";
+import { registerMergeRequestTools } from "./tools/merge_requests.js";
+import { registerUtilTools } from "./tools/utils.js";
+function getEnvOrExit(name, description) {
+    const value = process.env[name];
+    if (!value) {
+        console.error(`Erreur: la variable d'environnement ${name} est requise.\n` +
+            `${description}\n` +
+            `Exemple: ${name}=xxx npx @wanadev/mcp-gitlab`);
+        process.exit(1);
+    }
+    return value;
+}
+async function main() {
+    const token = getEnvOrExit("GITLAB_TOKEN", "Token d'acces personnel GitLab (PAT) avec les scopes api ou read_api.");
+    const baseUrl = process.env["GITLAB_BASE_URL"] ?? "https://gitlab.com";
+    const readOnly = process.env["GITLAB_READ_ONLY"] === "true";
+    const client = new GitLabClient({ baseUrl, token, readOnly });
+    const server = new McpServer({
+        name: "@wanadev/mcp-gitlab",
+        version: "1.0.0",
+    });
+    registerEpicTools(server, client);
+    registerIssueTools(server, client);
+    registerMilestoneTools(server, client);
+    registerMergeRequestTools(server, client);
+    registerUtilTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("@wanadev/mcp-gitlab demarre (stdio)");
+    if (readOnly) {
+        console.error("Mode lecture seule actif (GITLAB_READ_ONLY=true)");
+    }
+}
+main().catch((error) => {
+    console.error("Erreur fatale:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,SAAS,YAAY,CAAC,IAAY,EAAE,WAAmB;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,uCAAuC,IAAI,iBAAiB;YAC1D,GAAG,WAAW,IAAI;YAClB,YAAY,IAAI,8BAA8B,CACjD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,YAAY,CACxB,cAAc,EACd,uEAAuE,CACxE,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,MAAM,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACrD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}