mcp-gitlabpr 1.0.2__tar.gz → 2.0.0__tar.gz

{mcp_gitlabpr-1.0.2 → mcp_gitlabpr-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcp-gitlabpr
-Version: 1.0.2
+Version: 2.0.0
 Summary: MCP server para merge requests do GitLab (API v4, CE 10.8+): listar, obter, criar e mesclar, só no projeto do workspace
 Project-URL: Repository, https://github.com/dxaraujo/mcp-gitlabpr
 Author-email: Daniel Xavier Araújo <danielxaraujo@gmail.com>
@@ -18,25 +18,15 @@ v4 com personal access token e só os parâmetros que já existem na **GitLab CE
 ([doc da 10.8.7](https://gitlab.com/gitlab-org/gitlab-foss/-/blob/v10.8.7/doc/api/merge_requests.md)), então também
 funciona em versões mais novas.
 
-## Credenciais
+## Configuração
 
-| SO | Arquivo |
-|---|---|
-| Linux/Mac | `~/.config/mcp-gitlabpr/gitlabpr.properties` |
-| Windows | `%APPDATA%\mcp-gitlabpr\gitlabpr.properties` |
-
-Para usar outro caminho, defina a variável de ambiente `MCP_GITLABPR_CONFIG`.
-
-```ini
-[DEFAULT]
-url = https://gitlab.SEU-SERVIDOR
-token = SEU_PERSONAL_ACCESS_TOKEN
-```
-
-O token sai de *Settings → Access Tokens* com o escopo `api` e vai no header `PRIVATE-TOKEN`.
+Só por variáveis de ambiente, no `env` do servidor MCP:
 
-**Certificados:** o MCP confia nas CAs da máquina e, se existir, em `gitlabpr-bundle.pem` na mesma pasta do
-`gitlabpr.properties` (cadeia PEM do servidor). `REQUESTS_CA_BUNDLE` também funciona.
+| Variável | Obrigatória | O que é |
+|---|---|---|
+| `GITLAB_API_URL` | sim | URL do GitLab (com ou sem `/api/v4`) |
+| `GITLAB_API_TOKEN` | sim | Personal access token com o escopo `api`, enviado no header `PRIVATE-TOKEN` (sai de *Settings → Access Tokens*) |
+| `GITLAB_CA_BUNDLE` | não | Caminho de um arquivo PEM com a cadeia do servidor, somada às CAs da máquina |
 
 ## Instalação
 
@@ -47,12 +37,22 @@ O token sai de *Settings → Access Tokens* com o escopo `api` e vai no header `
       "type": "stdio",
       "command": "uvx",
       "args": ["mcp-gitlabpr@latest"],
-      "env": { "UV_SYSTEM_CERTS": "true" }
+      "env": {
+        "GITLAB_API_URL": "https://gitlab.SEU-SERVIDOR",
+        "GITLAB_API_TOKEN": "${GITLAB_API_TOKEN}",
+        "UV_SYSTEM_CERTS": "true"
+      }
     }
   }
 }
 ```
 
+**Como passar as variáveis:** defina-as no bloco `env` do servidor MCP, como no exemplo. Para não gravar segredos em
+texto puro, use referências: `${VAR}` no Kiro IDE, `${env:VAR}` no Kiro CLI e `{env:VAR}` no opencode, e deixe o valor
+no gerenciador de segredos ou no ambiente de onde a ferramenta é aberta. Não há arquivo de configuração nem caminho padrão.
+No macOS, um app aberto pelo Dock não herda o `export` do shell: abra a ferramenta pelo terminal ou defina a variável no
+ambiente da sessão. Evite `export` no perfil do shell quando o agente puder rodar comandos, porque ele conseguiria ler o valor.
+
 Desenvolvimento:
 
 ```bash
@@ -69,7 +69,7 @@ informada, o caminho absoluto da raiz do workspace, e `origem` vem da branch atu
 sempre: o Kiro não inicia o MCP de um power na pasta do workspace, e sem `pasta` vale o cwd do processo. Fora de um
 repositório, a pessoa cola a URL do projeto no GitLab (ex.: `https://gitlab.SEU-SERVIDOR/grupo/projeto`; a URL de um MR do
 projeto também serve) e o agente a passa em `url_projeto`; aí `origem` é obrigatória no `gitlab_criar_mr`. O host do
-remote ou da URL precisa ser o do `gitlabpr.properties`; se não for, a tool recusa. `iid` é o número do MR no projeto (o `!123`
+remote ou da URL precisa ser o de `GITLAB_API_URL`; se não for, a tool recusa. `iid` é o número do MR no projeto (o `!123`
 da tela). Autor e responsável são usernames: o MCP os converte em id por `GET /users?username=`, porque a 10.8 só
 filtra por `author_id`/`assignee_id`.
 

{mcp_gitlabpr-1.0.2 → mcp_gitlabpr-2.0.0}/README.md

@@ -5,25 +5,15 @@ v4 com personal access token e só os parâmetros que já existem na **GitLab CE
 ([doc da 10.8.7](https://gitlab.com/gitlab-org/gitlab-foss/-/blob/v10.8.7/doc/api/merge_requests.md)), então também
 funciona em versões mais novas.
 
-## Credenciais
+## Configuração
 
-| SO | Arquivo |
-|---|---|
-| Linux/Mac | `~/.config/mcp-gitlabpr/gitlabpr.properties` |
-| Windows | `%APPDATA%\mcp-gitlabpr\gitlabpr.properties` |
-
-Para usar outro caminho, defina a variável de ambiente `MCP_GITLABPR_CONFIG`.
-
-```ini
-[DEFAULT]
-url = https://gitlab.SEU-SERVIDOR
-token = SEU_PERSONAL_ACCESS_TOKEN
-```
-
-O token sai de *Settings → Access Tokens* com o escopo `api` e vai no header `PRIVATE-TOKEN`.
+Só por variáveis de ambiente, no `env` do servidor MCP:
 
-**Certificados:** o MCP confia nas CAs da máquina e, se existir, em `gitlabpr-bundle.pem` na mesma pasta do
-`gitlabpr.properties` (cadeia PEM do servidor). `REQUESTS_CA_BUNDLE` também funciona.
+| Variável | Obrigatória | O que é |
+|---|---|---|
+| `GITLAB_API_URL` | sim | URL do GitLab (com ou sem `/api/v4`) |
+| `GITLAB_API_TOKEN` | sim | Personal access token com o escopo `api`, enviado no header `PRIVATE-TOKEN` (sai de *Settings → Access Tokens*) |
+| `GITLAB_CA_BUNDLE` | não | Caminho de um arquivo PEM com a cadeia do servidor, somada às CAs da máquina |
 
 ## Instalação
 
@@ -34,12 +24,22 @@ O token sai de *Settings → Access Tokens* com o escopo `api` e vai no header `
       "type": "stdio",
       "command": "uvx",
       "args": ["mcp-gitlabpr@latest"],
-      "env": { "UV_SYSTEM_CERTS": "true" }
+      "env": {
+        "GITLAB_API_URL": "https://gitlab.SEU-SERVIDOR",
+        "GITLAB_API_TOKEN": "${GITLAB_API_TOKEN}",
+        "UV_SYSTEM_CERTS": "true"
+      }
     }
   }
 }
 ```
 
+**Como passar as variáveis:** defina-as no bloco `env` do servidor MCP, como no exemplo. Para não gravar segredos em
+texto puro, use referências: `${VAR}` no Kiro IDE, `${env:VAR}` no Kiro CLI e `{env:VAR}` no opencode, e deixe o valor
+no gerenciador de segredos ou no ambiente de onde a ferramenta é aberta. Não há arquivo de configuração nem caminho padrão.
+No macOS, um app aberto pelo Dock não herda o `export` do shell: abra a ferramenta pelo terminal ou defina a variável no
+ambiente da sessão. Evite `export` no perfil do shell quando o agente puder rodar comandos, porque ele conseguiria ler o valor.
+
 Desenvolvimento:
 
 ```bash
@@ -56,7 +56,7 @@ informada, o caminho absoluto da raiz do workspace, e `origem` vem da branch atu
 sempre: o Kiro não inicia o MCP de um power na pasta do workspace, e sem `pasta` vale o cwd do processo. Fora de um
 repositório, a pessoa cola a URL do projeto no GitLab (ex.: `https://gitlab.SEU-SERVIDOR/grupo/projeto`; a URL de um MR do
 projeto também serve) e o agente a passa em `url_projeto`; aí `origem` é obrigatória no `gitlab_criar_mr`. O host do
-remote ou da URL precisa ser o do `gitlabpr.properties`; se não for, a tool recusa. `iid` é o número do MR no projeto (o `!123`
+remote ou da URL precisa ser o de `GITLAB_API_URL`; se não for, a tool recusa. `iid` é o número do MR no projeto (o `!123`
 da tela). Autor e responsável são usernames: o MCP os converte em id por `GET /users?username=`, porque a 10.8 só
 filtra por `author_id`/`assignee_id`.
 

mcp_gitlabpr-2.0.0/mcp_gitlabpr/config.py

@@ -0,0 +1,34 @@
+"""Carrega URL, token e certificado do GitLab das variáveis de ambiente."""
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+
+REQUIRED = ("GITLAB_API_URL", "GITLAB_API_TOKEN")
+
+
+@dataclass(frozen=True)
+class GitlabConfig:
+    url: str
+    token: str = field(repr=False)
+
+
+def ca_bundle() -> Path | None:
+    """Cadeia PEM extra apontada por GITLAB_CA_BUNDLE, somada às CAs da máquina."""
+    valor = os.environ.get("GITLAB_CA_BUNDLE", "").strip()
+    if not valor:
+        return None
+    path = Path(valor).expanduser()
+    if not path.is_file():
+        raise ValueError(f"GITLAB_CA_BUNDLE aponta para um arquivo que não existe: {path}")
+    return path
+
+
+def load_config() -> GitlabConfig:
+    missing = [k for k in REQUIRED if not os.environ.get(k, "").strip()]
+    if missing:
+        raise ValueError(f"Variável(is) de ambiente ausente(s): {', '.join(missing)}")
+    ca_bundle()  # arquivo errado aparece já na carga
+    url = os.environ["GITLAB_API_URL"].strip().rstrip("/").removesuffix("/api/v4")
+    return GitlabConfig(url=url, token=os.environ["GITLAB_API_TOKEN"].strip())

{mcp_gitlabpr-1.0.2 → mcp_gitlabpr-2.0.0}/mcp_gitlabpr/server.py

@@ -5,7 +5,7 @@ GitLab CE 10.8: autor e responsável vão por id (`author_username` é de versõ
 
 Só trabalha no projeto do repositório git do workspace (`pasta`; sem ela, a pasta em que o MCP roda), pelo remote
 origin ou o primeiro remote. Fora de um repositório, a pessoa cola a URL do projeto no GitLab (`url_projeto`). O host
-precisa ser o do gitlabpr.properties.
+precisa ser o de GITLAB_API_URL.
 """
 from __future__ import annotations
 
@@ -21,7 +21,7 @@ from requests.adapters import HTTPAdapter
 from mcp.server.mcpserver import MCPServer
 from mcp.server.mcpserver.exceptions import ToolError
 
-from .config import GitlabConfig, default_path, load_config
+from .config import GitlabConfig, ca_bundle, load_config
 
 mcp = MCPServer(
     "gitlabpr",
@@ -58,18 +58,13 @@ def tool(fn):
 
 # ---------------------------------------------------------------- HTTP
 
-def ca_bundle() -> Path:
-    """CAs extras (ex.: cadeia interna do GitLab), ao lado do gitlabpr.properties."""
-    return default_path().parent / "gitlabpr-bundle.pem"
-
-
 class _TlsAdapter(HTTPAdapter):
-    """CAs do sistema + gitlabpr-bundle.pem, se existir."""
+    """CAs do sistema + a cadeia de GITLAB_CA_BUNDLE, se definida."""
 
     def init_poolmanager(self, *args, **kwargs):
         ctx = ssl.create_default_context()
-        if ca_bundle().is_file():
-            ctx.load_verify_locations(ca_bundle())
+        if ca := ca_bundle():
+            ctx.load_verify_locations(ca)
         super().init_poolmanager(*args, ssl_context=ctx, **kwargs)
 
 
@@ -87,8 +82,8 @@ class GitlabSession:
             resp = self.session.request(method, url, timeout=TIMEOUT, **kwargs)
         except requests.exceptions.SSLError as exc:
             raise RuntimeError(
-                f"Certificado do servidor não confiável em {url}. Grave a cadeia de certificados (PEM) em "
-                f"{ca_bundle()} (ou aponte REQUESTS_CA_BUNDLE para ela) e reinicie o MCP. Detalhe: {exc}") from exc
+                f"Certificado do servidor não confiável em {url}. Instale a CA na máquina ou aponte GITLAB_CA_BUNDLE "
+                f"para a cadeia de certificados (PEM) e reinicie o MCP. Detalhe: {exc}") from exc
         if resp.status_code == 401:
             raise RuntimeError(f"HTTP 401 em {method} {url}: token inválido ou expirado (precisa do escopo `api`).")
         if not resp.ok:
@@ -101,7 +96,7 @@ _lock = threading.Lock()
 
 
 def get_session() -> GitlabSession:
-    """Sessão única por processo; carrega o gitlabpr.properties na primeira chamada."""
+    """Sessão única por processo; carrega as variáveis de ambiente na primeira chamada."""
     global _instance
     with _lock:
         if _instance is None:

{mcp_gitlabpr-1.0.2 → mcp_gitlabpr-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-gitlabpr"
-version = "1.0.2"
+version = "2.0.0"
 description = "MCP server para merge requests do GitLab (API v4, CE 10.8+): listar, obter, criar e mesclar, só no projeto do workspace"
 readme = "README.md"
 license = "MIT"

{mcp_gitlabpr-1.0.2 → mcp_gitlabpr-2.0.0}/tests/test_server.py

@@ -54,15 +54,19 @@ def fake(tmp_path_factory, monkeypatch):
     server.set_session(None)
 
 
-def test_config(tmp_path):
-    with pytest.raises(FileNotFoundError):
-        config.load_config(tmp_path / "x")
-    p = tmp_path / "gitlabpr.properties"
-    p.write_text("[DEFAULT]\nurl = https://gitlab.test/\n")
-    with pytest.raises(ValueError, match="token"):
-        config.load_config(p)
-    p.write_text("[DEFAULT]\nurl = https://gitlab.test/\ntoken = a%b\n")
-    assert config.load_config(p) == GitlabConfig(url="https://gitlab.test", token="a%b")
+def test_config(monkeypatch, tmp_path):
+    for k in ("GITLAB_API_URL", "GITLAB_API_TOKEN", "GITLAB_CA_BUNDLE"):
+        monkeypatch.delenv(k, raising=False)
+    monkeypatch.setenv("GITLAB_API_URL", "https://gitlab.test/api/v4/")
+    with pytest.raises(ValueError, match="GITLAB_API_TOKEN"):
+        config.load_config()
+    monkeypatch.setenv("GITLAB_API_TOKEN", "a%b")
+    assert config.load_config() == GitlabConfig(url="https://gitlab.test", token="a%b")
+    monkeypatch.setenv("GITLAB_CA_BUNDLE", str(tmp_path / "x.pem"))
+    with pytest.raises(ValueError, match="GITLAB_CA_BUNDLE"):
+        config.load_config()
+    (tmp_path / "x.pem").write_text("pem")
+    assert config.ca_bundle() == tmp_path / "x.pem"
 
 
 def test_listar_projeto(fake):

mcp_gitlabpr-1.0.2/mcp_gitlabpr/config.py

@@ -1,42 +0,0 @@
-"""Carrega URL e token do GitLab a partir de gitlabpr.properties."""
-from __future__ import annotations
-
-import configparser
-import os
-import sys
-from dataclasses import dataclass, field
-from pathlib import Path
-
-REQUIRED = ("url", "token")
-TEMPLATE = "[DEFAULT]\nurl = https://gitlab.SEU-SERVIDOR\ntoken = SEU_PERSONAL_ACCESS_TOKEN"
-
-
-@dataclass(frozen=True)
-class GitlabConfig:
-    url: str
-    token: str = field(repr=False)
-
-
-def default_path() -> Path:
-    if env := os.environ.get("MCP_GITLABPR_CONFIG"):
-        return Path(env)
-    if sys.platform == "win32":
-        return Path(os.environ["APPDATA"]) / "mcp-gitlabpr" / "gitlabpr.properties"
-    return Path.home() / ".config" / "mcp-gitlabpr" / "gitlabpr.properties"
-
-
-def load_config(path: Path | None = None) -> GitlabConfig:
-    path = path or default_path()
-    if not path.is_file():
-        raise FileNotFoundError(f"Arquivo de credenciais não encontrado: {path}\nCrie-o com:\n{TEMPLATE}")
-    # interpolation=None: tokens podem conter '%'
-    parser = configparser.ConfigParser(interpolation=None)
-    try:
-        parser.read(path, encoding="utf-8")
-    except configparser.Error as exc:
-        raise ValueError(f"{path} inválido: {exc}") from exc
-    section = parser.defaults()
-    missing = [k for k in REQUIRED if not section.get(k, "").strip()]
-    if missing:
-        raise ValueError(f"Chave(s) ausente(s) em {path} [DEFAULT]: {', '.join(missing)}")
-    return GitlabConfig(url=section["url"].strip().rstrip("/"), token=section["token"].strip())