pack-mcp-gitlab 0.1.0__py3-none-any.whl

pack_mcp_gitlab/__init__.py

@@ -0,0 +1 @@
+

pack_mcp_gitlab/client.py

@@ -0,0 +1,147 @@
+import gitlab
+
+from pack_mcp_gitlab.errors import handle_gitlab_error
+
+
+class GitLabClient:
+    def __init__(self, gitlab_url: str, gitlab_token: str):
+        if not gitlab_url or not gitlab_url.strip():
+            raise ValueError("GITLAB_URL é obrigatório. Configure a variável de ambiente.")
+        if not gitlab_token or not gitlab_token.strip():
+            raise ValueError("GITLAB_TOKEN é obrigatório. Configure a variável de ambiente.")
+
+        self.gl = gitlab.Gitlab(gitlab_url, private_token=gitlab_token)
+
+    @handle_gitlab_error
+    def list_merge_requests(self, project_path: str, state: str = "opened") -> list[dict]:
+        """Retorna lista de MRs do projeto filtrados por estado."""
+        project = self.gl.projects.get(project_path)
+        mrs = project.mergerequests.list(state=state, per_page=100, iterator=True)
+        return [
+            {
+                "iid": mr.iid,
+                "title": mr.title,
+                "author": mr.author["username"],
+                "source_branch": mr.source_branch,
+                "target_branch": mr.target_branch,
+                "state": mr.state,
+                "web_url": mr.web_url,
+                "created_at": mr.created_at,
+                "updated_at": mr.updated_at,
+            }
+            for mr in mrs
+        ]
+
+    @handle_gitlab_error
+    def get_merge_request(self, project_path: str, mr_iid: int) -> dict:
+        """Retorna detalhes completos de um MR."""
+        project = self.gl.projects.get(project_path)
+        mr = project.mergerequests.get(mr_iid)
+        return {
+            "iid": mr.iid,
+            "title": mr.title,
+            "description": mr.description,
+            "state": mr.state,
+            "author": {
+                "name": mr.author["name"],
+                "username": mr.author["username"],
+            },
+            "source_branch": mr.source_branch,
+            "target_branch": mr.target_branch,
+            "web_url": mr.web_url,
+            "created_at": mr.created_at,
+            "updated_at": mr.updated_at,
+        }
+
+    @handle_gitlab_error
+    def get_merge_request_changes(self, project_path: str, mr_iid: int) -> list[dict]:
+        """Retorna diffs/alterações de um MR."""
+        project = self.gl.projects.get(project_path)
+        mr = project.mergerequests.get(mr_iid)
+        changes = mr.changes()["changes"]
+        return [
+            {
+                "new_path": change["new_path"],
+                "old_path": change["old_path"],
+                "new_file": change["new_file"],
+                "renamed_file": change["renamed_file"],
+                "deleted_file": change["deleted_file"],
+                "diff": change["diff"],
+            }
+            for change in changes
+        ]
+
+    @handle_gitlab_error
+    def get_file_content(self, project_path: str, file_path: str, ref: str = "HEAD") -> dict:
+        """Retorna conteúdo de arquivo decodificado em UTF-8."""
+        project = self.gl.projects.get(project_path)
+        f = project.files.get(file_path=file_path, ref=ref)
+        return {
+            "file_path": file_path,
+            "ref": ref,
+            "content": f.decode().decode("utf-8"),
+        }
+
+    @handle_gitlab_error
+    def create_merge_request_note(self, project_path: str, mr_iid: int, body: str) -> dict:
+        """Cria comentário no MR. Retorna id e confirmação."""
+        if not body or not body.strip():
+            raise ValueError("O conteúdo do comentário (body) é obrigatório.")
+        project = self.gl.projects.get(project_path)
+        mr = project.mergerequests.get(mr_iid)
+        note = mr.notes.create({"body": body})
+        return {"id": note.id, "success": True}
+
+    @handle_gitlab_error
+    def list_merge_request_notes(self, project_path: str, mr_iid: int) -> list[dict]:
+        """Retorna lista de comentários do MR."""
+        project = self.gl.projects.get(project_path)
+        mr = project.mergerequests.get(mr_iid)
+        notes = mr.notes.list(per_page=100, iterator=True)
+        return [
+            {
+                "id": note.id,
+                "body": note.body,
+                "author": {
+                    "name": note.author["name"],
+                    "username": note.author["username"],
+                },
+                "created_at": note.created_at,
+                "system": note.system,
+            }
+            for note in notes
+        ]
+
+    @handle_gitlab_error
+    def get_project(self, project_path: str) -> dict:
+        """Retorna informações do projeto."""
+        project = self.gl.projects.get(project_path)
+        return {
+            "id": project.id,
+            "name": project.name,
+            "path_with_namespace": project.path_with_namespace,
+            "description": project.description,
+            "default_branch": project.default_branch,
+            "web_url": project.web_url,
+            "visibility": project.visibility,
+        }
+
+    @handle_gitlab_error
+    def search_projects(self, search: str) -> list[dict]:
+        """Busca projetos por nome."""
+        projects = self.gl.projects.list(search=search, per_page=100)
+        return [
+            {
+                "id": project.id,
+                "name": project.name,
+                "path_with_namespace": project.path_with_namespace,
+                "description": project.description,
+                "web_url": project.web_url,
+            }
+            for project in projects
+        ]
+
+
+
+
+

pack_mcp_gitlab/errors.py

@@ -0,0 +1,71 @@
+import functools
+import logging
+import re
+
+import requests
+from gitlab.exceptions import (
+    GitlabAuthenticationError,
+    GitlabGetError,
+    GitlabHttpError,
+)
+from mcp.shared.exceptions import McpError
+from mcp.types import INTERNAL_ERROR, ErrorData
+
+logger = logging.getLogger(__name__)
+
+_TOKEN_PATTERN = re.compile(
+    r"(glpat-[A-Za-z0-9_\-]{20,}|private.token=[^\s&]+)", re.IGNORECASE
+)
+
+
+def _sanitize(message: str) -> str:
+    """Remove tokens de acesso de mensagens de log."""
+    return _TOKEN_PATTERN.sub("[REDACTED]", message)
+
+
+def handle_gitlab_error(func):
+    """Decorator que converte exceções GitLab em respostas de erro MCP.
+
+    Mapeia exceções específicas do python-gitlab e requests para
+    mensagens de erro descritivas via McpError, garantindo que
+    logs nunca exponham tokens de acesso.
+    """
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except GitlabAuthenticationError:
+            msg = "Falha de autenticação: token inválido ou expirado"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+        except GitlabGetError as e:
+            if getattr(e, "response_code", None) == 404:
+                msg = f"Recurso não encontrado: {_sanitize(str(e))}"
+            else:
+                msg = f"Erro GitLab: {_sanitize(str(e))}"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+        except GitlabHttpError as e:
+            if getattr(e, "response_code", None) == 403:
+                msg = "Permissão negada: token sem acesso para esta operação"
+            else:
+                msg = f"Erro HTTP GitLab: {_sanitize(str(e))}"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+        except requests.ConnectionError as e:
+            msg = f"Erro de conexão: {_sanitize(str(e))}"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+        except requests.Timeout as e:
+            msg = f"Timeout na conexão com GitLab: {_sanitize(str(e))}"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+        except McpError:
+            raise
+        except Exception as e:
+            msg = f"Erro inesperado: {type(e).__name__}: {_sanitize(str(e))}"
+            logger.error(_sanitize(msg))
+            raise McpError(ErrorData(code=INTERNAL_ERROR, message=msg))
+
+    return wrapper

pack_mcp_gitlab/server.py

@@ -0,0 +1,162 @@
+import json
+import os
+import logging
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("pack-mcp-gitlab")
+
+_client = None
+
+
+def get_gitlab_client():
+    """Inicializa e retorna o cliente GitLab com validação de config (singleton)."""
+    global _client
+    if _client is not None:
+        return _client
+
+    from pack_mcp_gitlab.client import GitLabClient
+
+    log_level = os.environ.get("LOG_LEVEL", "WARNING").upper()
+    logging.basicConfig(level=getattr(logging, log_level, logging.WARNING))
+
+    gitlab_url = os.environ.get("GITLAB_URL", "")
+    gitlab_token = os.environ.get("GITLAB_TOKEN", "")
+
+    _client = GitLabClient(gitlab_url, gitlab_token)
+    return _client
+
+
+@mcp.tool()
+async def list_merge_requests(project_path: str, state: str = "opened") -> str:
+    """Lista Merge Requests de um projeto no GitLab.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        state: Filtro por estado do MR. Valores: "opened", "closed", "merged", "all". Padrão: "opened".
+
+    Returns:
+        JSON array com MRs contendo: iid, title, author (username), source_branch, target_branch, state, web_url, created_at, updated_at.
+    """
+    client = get_gitlab_client()
+    result = client.list_merge_requests(project_path, state)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def get_merge_request(project_path: str, mr_iid: int) -> str:
+    """Obtém detalhes completos de um Merge Request específico.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        mr_iid: Número (IID) do Merge Request dentro do projeto.
+
+    Returns:
+        JSON com: iid, title, description, state, author (name, username), source_branch, target_branch, web_url, created_at, updated_at.
+    """
+    client = get_gitlab_client()
+    result = client.get_merge_request(project_path, mr_iid)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def get_merge_request_changes(project_path: str, mr_iid: int) -> str:
+    """Obtém as alterações (diffs) de um Merge Request, arquivo por arquivo.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        mr_iid: Número (IID) do Merge Request dentro do projeto.
+
+    Returns:
+        JSON array com um objeto por arquivo alterado contendo: new_path, old_path, new_file, renamed_file, deleted_file, diff (texto do diff unificado).
+    """
+    client = get_gitlab_client()
+    result = client.get_merge_request_changes(project_path, mr_iid)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def get_file_content(project_path: str, file_path: str, ref: str = "HEAD") -> str:
+    """Lê o conteúdo de um arquivo do repositório GitLab.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        file_path: Caminho do arquivo dentro do repositório (ex: "src/main/App.java").
+        ref: Branch, tag ou commit SHA de onde ler o arquivo. Padrão: "HEAD".
+
+    Returns:
+        JSON com: file_path, ref, content (conteúdo UTF-8 do arquivo).
+    """
+    client = get_gitlab_client()
+    result = client.get_file_content(project_path, file_path, ref)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def create_merge_request_note(project_path: str, mr_iid: int, body: str) -> str:
+    """Posta um comentário (note) em um Merge Request no GitLab.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        mr_iid: Número (IID) do Merge Request dentro do projeto.
+        body: Texto do comentário a ser postado. Suporta Markdown do GitLab. Não pode ser vazio.
+
+    Returns:
+        JSON com: id (ID do comentário criado), success (true).
+    """
+    client = get_gitlab_client()
+    result = client.create_merge_request_note(project_path, mr_iid, body)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def list_merge_request_notes(project_path: str, mr_iid: int) -> str:
+    """Lista todos os comentários (notes) de um Merge Request.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+        mr_iid: Número (IID) do Merge Request dentro do projeto.
+
+    Returns:
+        JSON array com notes contendo: id, body, author (name, username), created_at, system (true se é nota automática do GitLab).
+    """
+    client = get_gitlab_client()
+    result = client.list_merge_request_notes(project_path, mr_iid)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def get_project(project_path: str) -> str:
+    """Obtém informações de um projeto no GitLab.
+
+    Args:
+        project_path: Caminho completo do projeto (ex: "grupo/subgrupo/projeto").
+
+    Returns:
+        JSON com: id, name, path_with_namespace, description, default_branch, web_url, visibility.
+    """
+    client = get_gitlab_client()
+    result = client.get_project(project_path)
+    return json.dumps(result)
+
+
+@mcp.tool()
+async def search_projects(search: str) -> str:
+    """Busca projetos no GitLab por nome. Use quando não souber o caminho exato do projeto.
+
+    Args:
+        search: Termo de busca (nome ou parte do nome do projeto).
+
+    Returns:
+        JSON array com projetos encontrados contendo: id, name, path_with_namespace, description, web_url. Retorna lista vazia se nenhum projeto corresponder.
+    """
+    client = get_gitlab_client()
+    result = client.search_projects(search)
+    return json.dumps(result)
+
+
+def main():
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

pack_mcp_gitlab-0.1.0.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: pack-mcp-gitlab
+Version: 0.1.0
+Summary: MCP server for GitLab API integration
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: python-gitlab>=4.0.0
+Provides-Extra: dev
+Requires-Dist: hypothesis; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'

pack_mcp_gitlab-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+pack_mcp_gitlab/__init__.py,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+pack_mcp_gitlab/client.py,sha256=Cu7iOPQITJYuRw1pofr6Mn_YN8FgX-Nweh_N9lBDqyc,5602
+pack_mcp_gitlab/errors.py,sha256=XNfx5JHwYpC--_UB2FNl64i4nFiYDwE6D5CWcZYYR04,2696
+pack_mcp_gitlab/server.py,sha256=GrxJfGb6GERcAqR_40UG4GUd7ftKikx4paE5Rwtuggo,5637
+pack_mcp_gitlab-0.1.0.dist-info/METADATA,sha256=xuYSSpmyrC14FV9J7Jy6eskOXPTNe8fPySqEcQvID0E,338
+pack_mcp_gitlab-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+pack_mcp_gitlab-0.1.0.dist-info/entry_points.txt,sha256=spumy7QrxQlUX_P1veyIpgazpD7IwEXLygjRMW2lU2w,64
+pack_mcp_gitlab-0.1.0.dist-info/RECORD,,

pack_mcp_gitlab-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

pack_mcp_gitlab-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pack-mcp-gitlab = pack_mcp_gitlab.server:main