jenkins-mcp-toolkit
Servidor MCP do Jenkins. Expõe como tools MCP as capacidades de consulta e operação no Jenkins: detecção de build por commit, status, listagem de builds, console, artefatos, navegação de multibranch (branches) e o input step de promoção.
É consumido por um Kiro Power via uvx.
Rodar (desenvolvimento)
A partir da raiz do projeto:
uvx --from . jenkins-mcp-toolkit
Depois de publicado no PyPI, basta:
uvx jenkins-mcp-toolkit
Configuração (variáveis de ambiente)
| Variável | Obrigatória | Default | Descrição |
|---|---|---|---|
JENKINS_URL |
sim | — | URL base do Jenkins |
JENKINS_USERNAME |
sim | — | usuário para HTTP Basic |
JENKINS_TOKEN |
sim | — | token de API para HTTP Basic |
JENKINS_JOB_DEFAULT |
não | — | job padrão (caminho completo) usado quando a tool é chamada sem job |
JENKINS_VERIFY_SSL |
não | true |
verificar certificado TLS |
JENKINS_TIMEOUT |
não | 30 |
timeout HTTP (segundos) |
JENKINS_READ_ONLY |
não | false |
se true, só as tools de leitura ficam ativas |
JENKINS_MCP_ENV_FILE |
não | — | caminho de um .env alternativo (ver abaixo) |
As variáveis podem vir do ambiente do processo (ex.: do env do mcp.json) ou de um
arquivo .env que o servidor carrega automaticamente (recomendado — mantém o token fora de
arquivos versionados). Veja a seção seguinte.
Configuração via arquivo .env (recomendado)
O servidor carrega, na inicialização, um arquivo .env com as variáveis acima. Isso evita
colocar o token no mcp.json (que é versionado). Precedência: uma variável já definida no
ambiente do processo vence o valor do .env — o arquivo só preenche o que falta.
Onde fica o .env
Por padrão, em ~/.mcp/jenkins/.env (uniforme nos três sistemas). Para usar outro
caminho, defina JENKINS_MCP_ENV_FILE com o caminho desejado.
| Sistema | Caminho do .env |
|---|---|
| Linux / WSL (Ubuntu) | ~/.mcp/jenkins/.env |
| Windows nativo | C:\Users\<você>\.mcp\jenkins\.env |
Regra: o
.envvai no~/.mcp/jenkins/do ambiente onde o Kiro/servidor roda. Se o seu Kiro roda dentro do WSL, use o~do WSL; se roda no Windows nativo, use o do Windows.
Setup
A partir do .env.example deste diretório:
mkdir -p ~/.mcp/jenkins
cp .env.example ~/.mcp/jenkins/.env
chmod 600 ~/.mcp/jenkins/.env # contém o token: restrinja a leitura
$EDITOR ~/.mcp/jenkins/.env # preencha JENKINS_USERNAME e JENKINS_TOKEN
⚠️ Nunca versione o
.envreal (ele tem o token). O.gitignorejá ignora.env; apenas o.env.example(sem segredo) é versionado.
Tools
As tools são marcadas com tags read (consulta) e write (ação). Em modo read-only
(JENKINS_READ_ONLY=true), as tools write ficam desabilitadas.
Testes
.venv/bin/pytest # ou: uv run pytest
Publicação (PyPI)
O pacote é distribuído no PyPI como jenkins-mcp-toolkit (licença MPL-2.0).
uv build # gera dist/jenkins_mcp_toolkit-<versão>-*.whl e .tar.gz
uv publish # publica no PyPI (requer credenciais; passo manual)
Depois de publicado, os consumidores usam a versão pinada:
uvx jenkins-mcp-toolkit==0.4.0
O
uv publishé um passo manual do mantenedor — exige credenciais do PyPI e é irreversível (o PyPI não permite reusar o par nome+versão depois de publicado).
1 maintainer
Metadata
1 maintainer
Release files for jenkins-mcp-toolkit 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jenkins_mcp_toolkit-0.4.0.tar.gz | 166.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jenkins_mcp_toolkit-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 190.3 kB
Release files / jenkins_mcp_toolkit-0.4.0.tar.gz
| Download URL | jenkins_mcp_toolkit-0.4.0.tar.gz |
|---|---|
| Size | 166.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c65c97d857db1bd957ee272850b5ed8787008185d3ace0d3c9e140e061cedcab
|
|
BLAKE2b-256 checksum How to use checksums |
92ee3e441a0db0e9756bf9d0e805273a5230291984b38528fcdf13001dea46c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / jenkins_mcp_toolkit-0.4.0-py3-none-any.whl
| Download URL | jenkins_mcp_toolkit-0.4.0-py3-none-any.whl |
|---|---|
| Size | 24.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a438a20219fb52ffeaa0b62ea2d6b6805a00c07b763385a30aafa7a28678643
|
|
BLAKE2b-256 checksum How to use checksums |
b97e614a7daebecd1362ac2899be63e98075d335dad436882782408198db6877
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
