Development¶
make test # go test -race ./...
make cover # run tests and print a coverage summary
make vet # go vet ./...
make fmt-check # gofmt verification
make lint # golangci-lint
make all # fmt-check + vet + lint + test + build
make e2e # end-to-end tests against a real Jenkins in Docker
internal/jenkinsx and internal/jenkinsx/tools test against httptest.Server fixtures rather than a real Jenkins instance, covering CSRF crumb caching/refresh, HTTP status error mapping, and each tool handler's request shape and response decoding — including a read-only-mode test per toolset confirming its Write tool(s) are suppressed. cmd/jenkins also has an integration test that builds and drives the real binary over its actual stdin/stdout (unlike every other test, which uses an in-memory transport) — it points JENKINS_URL at a local mock server and strips every inherited JENKINS_* environment variable first, so it never depends on or reaches a real Jenkins instance regardless of what's configured on the machine running it.
End-to-end tests¶
make e2e runs the suite in e2e/ against a real Jenkins instance rather than a mock. It boots jenkins/jenkins:lts in Docker on a random free port, provisions an admin user and a real API token via an init.groovy.d script (with the setup wizard disabled), then builds the jenkins binary and drives it as a subprocess over real line-delimited JSON-RPC — the same way an MCP client would. It creates a freestyle job, triggers a build, polls it to completion, and reads its console log, which exercises the CSRF crumb handshake, the queue-item Location header parse, and progressive log reading against the real API.
These tests are behind the e2e build tag, so go test ./... never runs them and the default suite stays hermetic and Docker-free. Requirements and timing:
- A running Docker daemon. The first run also pulls the ~500MB Jenkins image.
make e2eruns two suites.TestEndToEnduses the stockjenkins/jenkins:ltsimage.TestPipelineEndToEndadditionallydocker builds a derived image that installs the Pipeline plugins (workflow-aggregator,pipeline-stage-view) viajenkins-plugin-cli, so its first run downloads plugins from the Jenkins update center and can take several minutes. That image is cached and reused; it is only rebuilt when absent.- Roughly 15-45s once both images are cached (Jenkins boots in about 6s), plus pull and plugin-download time on a cold cache.
- The container is removed via
t.Cleanupeven when a test fails; on failure its last 60 log lines are dumped to help diagnose provisioning problems.
Smoke-testing the protocol¶
List the tools over stdio without an MCP client:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"s","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| JENKINS_URL=https://ci.example.com JENKINS_USER=alice JENKINS_TOKEN=tok JENKINS_READONLY=true ./bin/jenkins mcp
Or browse interactively with the MCP Inspector:
Adding a tool¶
See Tools.
Releasing¶
Releases are tag-triggered (GoReleaser via CI, .goreleaser.yaml); make next/make bump compute and tag the next version from conventional commits.