{"_id":"jenkins-mcp","_rev":"4-9338b2492a7f60e2cbd53f8a780d269e","name":"jenkins-mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.0.1":{"name":"jenkins-mcp","version":"0.0.1","author":"","license":"ISC","_id":"jenkins-mcp@0.0.1","maintainers":[{"name":"unadlib","email":"unadlib@gmail.com"}],"dist":{"shasum":"2e71750d6bd68ab168e62f998e006de9f686636e","tarball":"https://registry.npmjs.org/jenkins-mcp/-/jenkins-mcp-0.0.1.tgz","fileCount":1,"integrity":"sha512-52nipmHzHTM2ysyAOYljkxcMf9Bff+igeo/rpE4PHBZmwADECQ6/tBec1H37VpfAJCiLpejctl7Zq24ErN14Eg==","signatures":[{"sig":"MEQCICvX30ZF0t6sZKfoxqYvvvLVwgNJquVpg2WShkzE3wA6AiBp/FWXKOVPibDnnHwmrdJgZxrfYRpznhDLzBpnRq0cIQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":207},"main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"unadlib","email":"unadlib@gmail.com"},"_npmVersion":"10.9.4","description":"","directories":{},"_nodeVersion":"22.21.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/jenkins-mcp_0.0.1_1772022463519_0.6925389646119742","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"jenkins-mcp","version":"0.1.0","keywords":["mcp","modelcontextprotocol","jenkins","automation"],"license":"MIT","_id":"jenkins-mcp@0.1.0","maintainers":[{"name":"unadlib","email":"unadlib@gmail.com"}],"homepage":"https://github.com/mcpland/jenkins-mcp#readme","bugs":{"url":"https://github.com/mcpland/jenkins-mcp/issues"},"bin":{"jenkins-mcp":"dist/index.js"},"dist":{"shasum":"80d1191532eece33f5ab9a11f23cabe79ae0bc25","tarball":"https://registry.npmjs.org/jenkins-mcp/-/jenkins-mcp-0.1.0.tgz","fileCount":6,"integrity":"sha512-JwxxoID2m8tfpmM4gfrOVugg67bBOykwzso92U2AYtMLJu+C05XsPLXXAoGmmcJj9kPNnpbpDNKqbbWyvTMs3Q==","signatures":[{"sig":"MEYCIQCKlcf/CDwkVW4pSRgp9C5PGhC9FODPna0gEmJPA6GJ2AIhAKUXQv0ExVCUNtyBQ5B1kgldXQp7HpId/aB7sBdbuJEa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/jenkins-mcp@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":155296},"type":"module","config":{"commitizen":{"path":"cz-git"}},"engines":{"node":">=20.0.0","pnpm":">=10.0.0"},"gitHead":"2469be577e1031bec120c089400d9ac0d520a0d9","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint .","test":"vitest run","build":"tsup","check":"pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build","clean":"rimraf coverage dist","start":"node dist/index.js","commit":"cz","format":"prettier . --write","release":"pnpm build && pnpm changeset publish","lint:fix":"eslint . --fix","changeset":"changeset","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier . --check","test:coverage":"vitest run --coverage","version-packages":"changeset version"},"_npmUser":{"name":"unadlib","email":"unadlib@gmail.com"},"repository":{"url":"git+https://github.com/mcpland/jenkins-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"A MCP server for Jenkins","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.3.6","undici":"^7.22.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.29.3","devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","cz-git":"^1.12.0","eslint":"^10.0.2","rimraf":"^6.1.3","vitest":"^4.0.18","globals":"^17.3.0","prettier":"^3.8.1","@eslint/js":"^10.0.1","commitizen":"^4.3.1","typescript":"^5.9.3","@types/node":"^25.3.0","@changesets/cli":"^2.29.8","typescript-eslint":"^8.56.1","@vitest/coverage-v8":"^4.0.18","eslint-config-prettier":"^10.1.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/jenkins-mcp_0.1.0_1772041725736_0.4613611242619986","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"jenkins-mcp","version":"0.2.0","keywords":["mcp","modelcontextprotocol","jenkins","automation"],"license":"MIT","_id":"jenkins-mcp@0.2.0","maintainers":[{"name":"unadlib","email":"unadlib@gmail.com"}],"homepage":"https://github.com/mcpland/jenkins-mcp#readme","bugs":{"url":"https://github.com/mcpland/jenkins-mcp/issues"},"bin":{"jenkins-mcp":"dist/index.js"},"dist":{"shasum":"dc59d01b2b64983f0b6bcbda8db1c7217641836a","tarball":"https://registry.npmjs.org/jenkins-mcp/-/jenkins-mcp-0.2.0.tgz","fileCount":6,"integrity":"sha512-l39EJfOF6hMHjyFMmXX/Es2yxHiz/mnX37CI88qEcX4m2zqGyFDznReaxpAZfgvRGgTjD0gxB8O0sN92jpaxRQ==","signatures":[{"sig":"MEQCIHq4cmvmZQT7HP3egqsY8sYrf0GZ1pro0eUbco5c/soHAiA2ZXqDJuWR/qmp7PmTgfzKstjeIgcZrP8KalY0klYbcg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/jenkins-mcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":236793},"type":"module","config":{"commitizen":{"path":"cz-git"}},"engines":{"node":">=20.0.0","pnpm":">=10.0.0"},"gitHead":"e75a015be7c536f2e2beb5a78d609bfe91a50cde","private":false,"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint .","test":"vitest run","build":"tsup","check":"pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build","clean":"rimraf coverage dist","start":"node dist/index.js","commit":"cz","format":"prettier . --write","release":"pnpm build && pnpm changeset publish","lint:fix":"eslint . --fix","changeset":"changeset","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier . --check","test:coverage":"vitest run --coverage","version-packages":"changeset version"},"_npmUser":{"name":"unadlib","email":"unadlib@gmail.com"},"repository":{"url":"git+https://github.com/mcpland/jenkins-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"A MCP server for Jenkins","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.3.6","undici":"^7.22.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.29.3","devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","cz-git":"^1.12.0","eslint":"^10.0.2","rimraf":"^6.1.3","vitest":"^4.0.18","globals":"^17.3.0","prettier":"^3.8.1","@eslint/js":"^10.0.1","commitizen":"^4.3.1","typescript":"^5.9.3","@types/node":"^25.3.0","@changesets/cli":"^2.29.8","typescript-eslint":"^8.56.1","@vitest/coverage-v8":"^4.0.18","eslint-config-prettier":"^10.1.8","@changesets/changelog-github":"^0.5.2"},"_npmOperationalInternal":{"tmp":"tmp/jenkins-mcp_0.2.0_1773751257765_0.535882222751447","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"jenkins-mcp","version":"0.2.1","description":"A MCP server for Jenkins","type":"module","license":"MIT","private":false,"repository":{"type":"git","url":"git+https://github.com/mcpland/jenkins-mcp.git"},"homepage":"https://github.com/mcpland/jenkins-mcp#readme","bugs":{"url":"https://github.com/mcpland/jenkins-mcp/issues"},"keywords":["mcp","modelcontextprotocol","jenkins","automation"],"engines":{"node":">=20.0.0","pnpm":">=10.0.0"},"packageManager":"pnpm@10.29.3","bin":{"jenkins-mcp":"dist/index.js"},"scripts":{"build":"tsup","clean":"rimraf coverage dist","dev":"tsx watch src/index.ts","start":"node dist/index.js","commit":"cz","lint":"eslint .","lint:fix":"eslint . --fix","format":"prettier . --write","format:check":"prettier . --check","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","check":"pnpm format:check && pnpm lint && pnpm typecheck && pnpm test && pnpm build","changeset":"changeset","version-packages":"changeset version","release":"pnpm build && pnpm changeset publish"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","undici":"^7.22.0","zod":"^4.3.6"},"devDependencies":{"@changesets/changelog-github":"^0.5.2","@changesets/cli":"^2.29.8","@eslint/js":"^10.0.1","@types/node":"^25.3.0","@vitest/coverage-v8":"^4.0.18","commitizen":"^4.3.1","cz-git":"^1.12.0","eslint":"^10.0.2","eslint-config-prettier":"^10.1.8","globals":"^17.3.0","prettier":"^3.8.1","rimraf":"^6.1.3","tsup":"^8.5.1","tsx":"^4.21.0","typescript":"^5.9.3","typescript-eslint":"^8.56.1","vitest":"^4.0.18"},"config":{"commitizen":{"path":"cz-git"}},"_id":"jenkins-mcp@0.2.1","gitHead":"640c5e626c9003fbef5b2043b30f6a8440599fc7","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-ySgwtJ2Y1gZbI+EFJ3S+rLNjCS59oUQB0LmL7s/uqps6NYcVYPWKE25JK+VekB5hXHNB3NT3hnSgSXeX6OAx0A==","shasum":"f73a47c628ea598c6d155ee3da91f6a04b627048","tarball":"https://registry.npmjs.org/jenkins-mcp/-/jenkins-mcp-0.2.1.tgz","fileCount":6,"unpackedSize":243832,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/jenkins-mcp@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCaGSGNtPeVjSkBHLpbWwzrXM4pFOIut055IwGWVvs1EgIhAPe7+LmR7J7/v/AFZ1cN22mINRb7YHVYdY/AKsq4wUDa"}]},"_npmUser":{"name":"unadlib","email":"unadlib@gmail.com"},"directories":{},"maintainers":[{"name":"unadlib","email":"unadlib@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jenkins-mcp_0.2.1_1773755803879_0.9328141486652759"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-25T12:27:43.518Z","modified":"2026-03-17T13:56:44.324Z","0.0.1":"2026-02-25T12:27:43.650Z","0.1.0":"2026-02-25T17:48:45.895Z","0.2.0":"2026-03-17T12:40:57.895Z","0.2.1":"2026-03-17T13:56:44.047Z"},"bugs":{"url":"https://github.com/mcpland/jenkins-mcp/issues"},"license":"MIT","homepage":"https://github.com/mcpland/jenkins-mcp#readme","keywords":["mcp","modelcontextprotocol","jenkins","automation"],"repository":{"type":"git","url":"git+https://github.com/mcpland/jenkins-mcp.git"},"description":"A MCP server for Jenkins","maintainers":[{"name":"unadlib","email":"unadlib@gmail.com"}],"readme":"# jenkins-mcp\n\n![Node CI](https://github.com/mcpland/jenkins-mcp/workflows/Node%20CI/badge.svg)\n[![npm](https://img.shields.io/npm/v/jenkins-mcp.svg)](https://www.npmjs.com/package/jenkins-mcp)\n![license](https://img.shields.io/npm/l/jenkins-mcp)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides AI assistants with full access to Jenkins CI/CD systems. Built with TypeScript and Node.js, it enables Claude, Cursor, and other MCP-compatible clients to query, manage, and control Jenkins jobs, builds, nodes, and queues through natural language.\n\n## Table of Contents\n\n- [Features](#features)\n- [Usage](#usage)\n- [Configuration](#configuration)\n- [MCP Client Integration](#mcp-client-integration)\n- [Available Tools](#available-tools)\n- [Transport Modes](#transport-modes)\n- [Architecture](#architecture)\n- [Development](#development)\n\n## Features\n\n- **23 MCP Tools** — Full Jenkins automation: jobs, builds, nodes, and queues\n- **3 Transport Modes** — `stdio`, `sse`, and `streamable-http` for different deployment scenarios\n- **Read-Only Mode** — Restrict to safe, read-only operations for controlled environments\n- **Per-Request Auth** — HTTP header-based Jenkins auth for multi-user/multi-tenant setups\n- **SSL Configuration** — Toggle SSL certificate verification for self-signed certs\n- **Session Singleton** — Reuse Jenkins client connections within a session for efficiency\n- **CSRF Protection** — Automatic crumb/token handling for Jenkins security\n- **Folder Support** — Full support for nested Jenkins folders and multi-branch pipelines\n- **TypeScript Strict Mode** — Fully typed codebase with strict compiler checks\n\n## Usage\n\n### MCP Client\n\nAdd the following to your MCP client configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"jenkins\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"jenkins-mcp\",\n        \"--jenkins-url\",\n        \"https://jenkins.example.com\",\n        \"--jenkins-username\",\n        \"your-username\",\n        \"--jenkins-password\",\n        \"your-api-token\"\n      ]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add jenkins -- npx jenkins-mcp \\\n  --jenkins-url https://jenkins.example.com \\\n  --jenkins-username your-username \\\n  --jenkins-password your-api-token\n```\n\n### Cursor\n\nAdd to your Cursor MCP settings (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"jenkins\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"jenkins-mcp\",\n        \"--jenkins-url\",\n        \"https://jenkins.example.com\",\n        \"--jenkins-username\",\n        \"your-username\",\n        \"--jenkins-password\",\n        \"your-api-token\"\n      ]\n    }\n  }\n}\n```\n\n### Read-Only Mode\n\nFor safety in production environments, use `--read-only` to disable all write operations:\n\n```json\n{\n  \"mcpServers\": {\n    \"jenkins\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"jenkins-mcp\",\n        \"--read-only\",\n        \"--jenkins-url\",\n        \"https://jenkins.example.com\",\n        \"--jenkins-username\",\n        \"your-username\",\n        \"--jenkins-password\",\n        \"your-api-token\"\n      ]\n    }\n  }\n}\n```\n\n## Configuration\n\nJenkins-MCP can be configured through CLI arguments, environment variables, or HTTP headers (for HTTP transports).\n\n### CLI Options\n\n```bash\njenkins-mcp [options]\n```\n\n| Option                                                           | Description                                           | Default   |\n| ---------------------------------------------------------------- | ----------------------------------------------------- | --------- |\n| `--jenkins-url`                                                  | Jenkins server URL                                    | —         |\n| `--jenkins-username`                                             | Jenkins username                                      | —         |\n| `--jenkins-password`                                             | Jenkins password or API token                         | —         |\n| `--jenkins-timeout`                                              | API request timeout in seconds                        | `5`       |\n| `--jenkins-verify-ssl` / `--no-jenkins-verify-ssl`               | Verify SSL certificates                               | `true`    |\n| `--jenkins-session-singleton` / `--no-jenkins-session-singleton` | Reuse Jenkins client within session                   | `true`    |\n| `--read-only`                                                    | Only register read-only tools                         | `false`   |\n| `--allow-full-console-output`                                    | Register the unsafe raw full-console-output tool      | `false`   |\n| `--transport`                                                    | Transport mode: `stdio` \\| `sse` \\| `streamable-http` | `stdio`   |\n| `--host`                                                         | Host for HTTP transports                              | `0.0.0.0` |\n| `--port`                                                         | Port for HTTP transports                              | `9887`    |\n\n### Environment Variables\n\nJenkins-MCP reads configuration from process environment variables. It does not auto-load `.env` files by itself.\n\nIf you use a local `.env` file, load it before starting the server (for example: `set -a; source .env; set +a`), then run `jenkins-mcp`.\n\nExample `.env` values:\n\n```bash\n# Jenkins server URL\njenkins_url=https://jenkins.example.com/\n\n# Jenkins basic auth\njenkins_username=your-username\njenkins_password=your-api-token\n\n# Optional runtime settings\njenkins_timeout=5\njenkins_verify_ssl=true\njenkins_session_singleton=true\n```\n\n### HTTP Headers (HTTP Transports Only)\n\nWhen using `sse` or `streamable-http` transport, Jenkins credentials can be provided per-request via HTTP headers. This enables multi-user scenarios where different requests authenticate against different Jenkins instances.\n\n| Header               | Description                   |\n| -------------------- | ----------------------------- |\n| `x-jenkins-url`      | Jenkins server URL            |\n| `x-jenkins-username` | Jenkins username              |\n| `x-jenkins-password` | Jenkins password or API token |\n\nEach provided header overrides the corresponding environment variable for that request. Missing header values fall back to environment configuration.\n\n## Available Tools\n\n### Job / Item Tools\n\n| Tool              | Description                               | Parameters                                              | Read-Only |\n| ----------------- | ----------------------------------------- | ------------------------------------------------------- | --------- |\n| `get_all_items`   | Get all jobs and folders from Jenkins     | —                                                       | Yes       |\n| `get_item`        | Get a specific job or folder by full name | `fullname`                                              | Yes       |\n| `get_item_config` | Get job configuration XML                 | `fullname`                                              | Yes       |\n| `set_item_config` | Update job configuration XML              | `fullname`, `config_xml`                                | No        |\n| `query_items`     | Search items with regex filters           | `class_pattern?`, `fullname_pattern?`, `color_pattern?` | Yes       |\n| `build_item`      | Trigger a job build                       | `fullname`, `build_type`, `params?`                     | No        |\n\n### Build Tools\n\n| Tool                        | Description                                                      | Parameters                                           | Read-Only |\n| --------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- | --------- |\n| `get_build`                 | Get build details                                                | `fullname`, `number?`                                | Yes       |\n| `get_build_console_tail`    | Get the recent tail of build console output                      | `fullname`, `number?`, `max_bytes?`                  | Yes       |\n| `get_build_console_chunk`   | Read incremental console output by offset                        | `fullname`, `start`, `number?`, `max_bytes?`         | Yes       |\n| `search_build_console`      | Search console output incrementally with excerpts                | `fullname`, `query`, `number?`, `max_bytes?`, ...    | Yes       |\n| `get_build_failure_excerpt` | Get focused failure excerpts and test hints via incremental scan | `fullname`, `number?`, `max_bytes?`, `max_excerpts?` | Yes       |\n| `get_build_console_output`  | Get raw full console log output                                  | `fullname`, `number?`                                | Yes       |\n| `get_build_test_report`     | Get test results report                                          | `fullname`, `number?`                                | Yes       |\n| `get_build_scripts`         | Extract build scripts (for replay)                               | `fullname`, `number?`                                | Yes       |\n| `get_running_builds`        | Get all currently running builds                                 | —                                                    | Yes       |\n| `stop_build`                | Stop a running build                                             | `fullname`, `number`                                 | No        |\n\nFor large logs, prefer `get_build_console_tail` -> `search_build_console` -> `get_build_console_chunk`.\n`get_build_console_output` is disabled by default and only registered when `--allow-full-console-output` is set.\nLarge-log helper tools enforce server-side byte ceilings even if the caller asks for more, and search-style tools scan logs incrementally instead of fetching `consoleText`.\n\n### Recommended Troubleshooting Flow\n\nFor a failed build, prefer this sequence:\n\n1. `get_build` to confirm `result`, `building`, and the target build number.\n2. `get_build_failure_excerpt` to get focused failure snippets plus failing test hints.\n3. `search_build_console` with anchors such as `Caused by:`, `ERROR`, `FAILED`, or a failing test name.\n4. `get_build_console_chunk` to continue reading from a returned `nextStart` offset when the first excerpt is not enough.\n5. `get_build_console_output` only when raw full log export is explicitly needed.\n\nFor a running build, prefer this sequence:\n\n1. `get_build` to confirm the build is still running.\n2. `get_build_console_tail` to inspect the latest output window.\n3. `search_build_console` for known error anchors in the recent window.\n4. `get_build_console_chunk` with the last `nextStart` value to keep polling without rereading old output.\n\n### Node Tools\n\n| Tool              | Description                            | Parameters           | Read-Only |\n| ----------------- | -------------------------------------- | -------------------- | --------- |\n| `get_all_nodes`   | Get all compute nodes                  | —                    | Yes       |\n| `get_node`        | Get a specific node with executor info | `name`               | Yes       |\n| `get_node_config` | Get node configuration XML             | `name`               | Yes       |\n| `set_node_config` | Update node configuration XML          | `name`, `config_xml` | No        |\n\n### Queue Tools\n\n| Tool                  | Description                        | Parameters | Read-Only |\n| --------------------- | ---------------------------------- | ---------- | --------- |\n| `get_all_queue_items` | Get all items waiting in the queue | —          | Yes       |\n| `get_queue_item`      | Get a specific queue item by ID    | `id`       | Yes       |\n| `cancel_queue_item`   | Cancel a queued item               | `id`       | No        |\n\n> Tools marked **Read-Only: No** are only available when `--read-only` is not set.\n\n## Transport Modes\n\n### stdio (Default)\n\nStandard input/output transport for direct MCP client integration. This is the recommended mode for Claude Desktop, Cursor, and other desktop MCP clients.\n\n```bash\njenkins-mcp --transport stdio \\\n  --jenkins-url https://jenkins.example.com \\\n  --jenkins-username user --jenkins-password token\n```\n\n### SSE (Server-Sent Events)\n\nHTTP-based transport using Server-Sent Events. Suitable for web-based clients or remote access scenarios.\n\n```bash\njenkins-mcp --transport sse \\\n  --host 127.0.0.1 --port 9887 \\\n  --jenkins-url https://jenkins.example.com \\\n  --jenkins-username user --jenkins-password token\n```\n\n- **SSE endpoint**: `GET /sse` — establishes an SSE connection and returns a session\n- **Message endpoint**: `POST /message?sessionId=<id>` — sends messages to the session\n\n### Streamable HTTP\n\nSession-based HTTP MCP transport over `/mcp`. Sessions are initialized via MCP `initialize`, then correlated with `mcp-session-id` in follow-up requests.\n\n```bash\njenkins-mcp --transport streamable-http \\\n  --host 127.0.0.1 --port 9887 \\\n  --jenkins-url https://jenkins.example.com \\\n  --jenkins-username user --jenkins-password token\n```\n\n- **MCP endpoint**: `POST /mcp` — handles all MCP protocol messages\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────┐\n│                  MCP Client                     │\n│          (Claude, Cursor, etc.)                 │\n└──────────────────┬──────────────────────────────┘\n                   │  MCP Protocol\n┌──────────────────▼──────────────────────────────┐\n│              Transport Layer                    │\n│      stdio │ SSE │ Streamable HTTP              │\n├──────────────────┬──────────────────────────────┤\n│           MCP Server (mcp.ts)                   │\n│     Tool registration & error handling          │\n├──────────────────┬──────────────────────────────┤\n│          Tool Handlers                          │\n│   item.ts │ build.ts │ node.ts │ queue.ts       │\n├──────────────────┬──────────────────────────────┤\n│         Jenkins REST Client                     │\n│    HTTP requests, auth, CSRF, timeout           │\n├──────────────────┬──────────────────────────────┤\n│           Jenkins Server                        │\n│         (REST API endpoint)                     │\n└─────────────────────────────────────────────────┘\n```\n\n**Key design patterns:**\n\n- **Dependency Injection** — `ToolRuntime` interface enables testable tool handlers\n- **Session Management** — HTTP transports map sessions to isolated runtime contexts\n- **Per-Request Auth** — HTTP headers override environment config for multi-tenant use\n- **Automatic CSRF** — Crumb tokens are fetched and cached transparently\n\n## Development\n\n### Scripts\n\n| Command              | Description                                          |\n| -------------------- | ---------------------------------------------------- |\n| `pnpm dev`           | Start in watch mode (auto-reload on changes)         |\n| `pnpm build`         | Build production bundle with tsup                    |\n| `pnpm test`          | Run tests with Vitest                                |\n| `pnpm test:watch`    | Run tests in watch mode                              |\n| `pnpm test:coverage` | Run tests with coverage report                       |\n| `pnpm check`         | Run all checks: format, lint, typecheck, test, build |\n| `pnpm lint`          | Run ESLint                                           |\n| `pnpm format`        | Format code with Prettier                            |\n| `pnpm commit`        | Interactive conventional commit with Commitizen      |\n| `pnpm changeset`     | Create a changeset for release                       |\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}