thruk-mcp 1.0.0__tar.gz

thruk_mcp-1.0.0/.env.example

@@ -0,0 +1,34 @@
+# Thruk REST API endpoint (no trailing slash). Example: https://monitor.example.com/thruk
+THRUK_BASE_URL=http://localhost/thruk
+
+# API key generated from the Thruk user profile page (X-Thruk-Auth-Key).
+# A super-user/system key can be combined with THRUK_AUTH_USER to impersonate.
+THRUK_API_KEY=changeme
+
+# Optional: user to impersonate (only effective with a superuser API key)
+THRUK_AUTH_USER=
+
+# Verify TLS certificate (set to false only for dev / self-signed)
+THRUK_VERIFY_SSL=true
+
+# Default request timeout in seconds
+THRUK_TIMEOUT=30
+
+# Optional: default backend(s) to query, comma-separated site names. Empty = all.
+THRUK_DEFAULT_BACKENDS=
+
+# ----------------- v0.6 security / multi-tenant knobs -----------------------
+# When true, all WRITE tools (acknowledge, schedule_*_downtime, recheck,
+# delete_*, run_background_query) are stripped from the MCP server. Use this
+# for agents that should only OBSERVE the monitoring state.
+THRUK_READ_ONLY=false
+
+# Optional allowlist of tool names (comma-separated, fnmatch wildcards
+# accepted). Empty = no filter. Example: "thruk_list_*,thruk_problems,thruk_stats"
+THRUK_ENABLED_TOOLS=
+
+# Emit a JSON audit line on stderr for every WRITE tool invocation.
+THRUK_AUDIT_LOG=true
+
+# Cap the number of concurrent in-flight HTTP requests to Thruk. 0 = unlimited.
+THRUK_MAX_CONCURRENT=0

thruk_mcp-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+      - run: pip install -e ".[dev]"
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+      - run: mypy src
+      - name: pytest with coverage
+        run: pytest -v --cov=thruk_mcp --cov-report=term --cov-report=xml --cov-fail-under=80
+      - name: Upload coverage to Codecov
+        if: matrix.python == '3.12'
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          flags: unittests
+          name: thruk-mcp-py3.12
+          fail_ci_if_error: true
+
+  docker:
+    needs: lint-test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-buildx-action@v3
+      - run: docker build -t thruk-mcp:ci .

thruk_mcp-1.0.0/.github/workflows/integration.yml

@@ -0,0 +1,59 @@
+name: Integration tests (live Thruk)
+
+on:
+  schedule:
+    - cron: "0 3 * * *"   # 03:00 UTC nightly
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  live:
+    runs-on: ubuntu-latest
+    # Don't fail the badge while the OMD demo image upstream is in flux;
+    # we treat live failures as warnings until v1.1.
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - run: pip install -e ".[dev]"
+
+      - name: Start OMD demo
+        run: docker compose -f compose.test.yml up -d
+
+      - name: Wait for OMD to boot
+        run: |
+          for i in $(seq 1 60); do
+            if curl -fsS -o /dev/null "http://localhost:8080/demo/thruk/cgi-bin/login.cgi"; then
+              echo "OMD ready after ${i}0s"; exit 0
+            fi
+            sleep 10
+          done
+          docker compose -f compose.test.yml logs --tail=200
+          exit 1
+
+      - name: Generate Thruk API key
+        id: apikey
+        run: |
+          key=$(./scripts/get-test-api-key.sh)
+          echo "::add-mask::$key"
+          echo "key=$key" >> "$GITHUB_OUTPUT"
+
+      - name: Run live integration tests
+        env:
+          THRUK_BASE_URL: http://localhost:8080/demo
+          THRUK_API_KEY: ${{ steps.apikey.outputs.key }}
+          THRUK_VERIFY_SSL: "false"
+        run: pytest -v -m integration
+
+      - name: Dump OMD logs on failure
+        if: failure()
+        run: docker compose -f compose.test.yml logs --tail=400
+
+      - name: Tear down
+        if: always()
+        run: docker compose -f compose.test.yml down -v

thruk_mcp-1.0.0/.github/workflows/pypi.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write   # required for PyPI trusted publishing
+
+jobs:
+  build:
+    name: Build wheel + sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install --upgrade build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI (trusted publisher)
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/thruk-mcp
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          # OIDC trusted publishing - no token needed once the pending
+          # publisher is configured on pypi.org (Account Settings -> Publishing).
+          # Required values for that pending publisher:
+          #   PyPI project name: thruk-mcp
+          #   Repository owner:  k9fr4n
+          #   Repository name:   thruk-mcp
+          #   Workflow name:     pypi.yml
+          #   Environment:       pypi
+          attestations: true

thruk_mcp-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: Release image
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  image:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: docker/setup-qemu-action@v3
+      - uses: docker/setup-buildx-action@v3
+
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository_owner }}/thruk-mcp
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          provenance: true
+          sbom: true

thruk_mcp-1.0.0/.gitignore

@@ -0,0 +1,24 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.env
+.env.local
+
+# Testing / tooling
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+.DS_Store

thruk_mcp-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+      - id: mypy
+        files: ^src/
+        additional_dependencies:
+          - httpx>=0.27
+          - pydantic>=2.5
+          - mcp[cli]>=1.2.0

thruk_mcp-1.0.0/CHANGELOG.md

@@ -0,0 +1,208 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-05-17
+
+First stable release. The API surface (29 tools, 5 resources, 3 prompts,
+14 env vars) is now committed to semantic versioning: future MAJOR bumps
+will be announced and documented ahead of time.
+
+### Added
+
+- `SUPPORT.md`: explicit Python / Thruk / MCP-client support matrix,
+  security reporting channel, release cadence.
+- `CONTRIBUTING.md`: development setup, PR conventions, tool/env-var
+  contribution checklists, release process for maintainers.
+- `UPGRADING.md`: per-MINOR migration notes covering 0.2.0 \u2192 1.0.0.
+- `.github/workflows/pypi.yml`: PyPI publish via trusted OIDC publisher
+  on every published GitHub release (no token required once the pending
+  publisher is configured on pypi.org).
+- `.github/workflows/integration.yml`: nightly live-Thruk integration
+  workflow that boots an OMD demo container, generates an API key, and
+  runs `pytest -m integration` against it. `continue-on-error: true`
+  for now so the badge stays green while the upstream demo image is in
+  flux.
+- `compose.test.yml`: docker-compose definition for the OMD demo
+  Thruk used by the integration workflow and by local maintainers.
+- `scripts/get-test-api-key.sh`: helper to mint a superuser API key
+  inside the running OMD container.
+- `tests/integration/test_live.py`: three smoke tests
+  (`/processinfo`, `/hosts`, `/hosts/stats`) gated on
+  `pytest.mark.integration` and skipped by default unless
+  `THRUK_API_KEY` is set.
+
+### Changed
+
+- `pytest` default invocation now passes `-m 'not integration'` so the
+  standard `pytest` command stays fast and offline; the integration
+  workflow overrides with `-m integration`.
+
+## [0.5.0] - 2026-05-17
+
+### Added
+
+- **Security & multi-tenant knobs**:
+  - `THRUK_READ_ONLY=true` strips every write tool from the server
+    (acknowledge, schedule_*_downtime, recheck, delete_*,
+    run_background_query). Read tools remain available.
+  - `THRUK_ENABLED_TOOLS=thruk_list_*,thruk_problems` restricts the
+    exposed tool surface via fnmatch wildcards. Empty = no filter.
+  - `THRUK_AUDIT_LOG=true` (default) emits one JSON line per write
+    tool invocation on the `thruk_mcp.audit` logger (stderr). Sensitive
+    keys (`api_key`, `password`, `token`) redacted as `***`. Payload:
+    `ts`, `tool`, `user`, `args`, `target`, `status`, `error`.
+  - `THRUK_MAX_CONCURRENT=N` caps in-flight HTTP requests with an
+    `asyncio.Semaphore` to protect the Thruk core from a looping LLM.
+- New module `src/thruk_mcp/audit.py`: `configure()`, `audited()`
+  decorator, `_redact()` helper.
+- 9 new security tests; coverage now **84.02 %** (was 82.10 %).
+- Codecov badge, Python versions badge and ghcr.io badge in README.
+- `catalog/server.yaml` declares the 4 new env vars in `config.env`
+  and `config.parameters` so the Docker MCP Toolkit UI renders them.
+- Strict Codecov upload in CI (`fail_ci_if_error: true`, scoped token,
+  `flags: unittests`).
+
+### Fixed
+
+- README and CHANGELOG: 6 literal `\u2014` / `\u2192` escape sequences
+  left over from earlier heredoc commits replaced with real Unicode
+  characters (em-dash, right-arrow).
+
+## [0.4.0] - 2026-05-17
+
+### Added
+
+- Comprehensive test suite: **63 passing tests, 82 % coverage**
+  (was 15 tests, ~50 %).
+  - `tests/test_tools.py` covers the 29 MCP tools (URL / method /
+    key params for each), including a regression test for the v0.2
+    acknowledge payload-key bug.
+  - `tests/test_resources.py` covers the 5 MCP resources.
+  - `tests/test_prompts.py` covers the 3 MCP prompts.
+  - `tests/test_config.py` covers `ThrukConfig.from_env()`.
+  - `tests/test_run_background.py` covers the 302 → 200 polling cycle
+    and the pass-through fallback.
+- `mypy` type-checking baseline (`warn_redundant_casts`,
+  `warn_unused_ignores`, `warn_unreachable`, `no_implicit_optional`,
+  `check_untyped_defs`). 0 errors on `src/`.
+- `ruff format` integrated alongside `ruff check`.
+- `.pre-commit-config.yaml` (ruff + ruff-format + mypy + standard
+  pre-commit hooks).
+- Coverage gate in CI: `pytest --cov-fail-under=80`.
+- Codecov upload on Python 3.12 CI matrix entry.
+- `[tool.coverage.*]` configuration with branch coverage and sensible
+  excludes. `integration` pytest marker registered for future live
+  tests.
+
+### Changed
+
+- **API cleanup** (small breaking change): `thruk_query` and
+  `thruk_run_background_query` arguments are now `params: dict` and
+  `data: dict` instead of `params_json: str` / `data_json: str`. The
+  previous JSON-string parameters were impossible to call through
+  FastMCP because pydantic auto-decodes JSON-looking strings before
+  reaching the function. Migration: pass a dict literal instead of a
+  JSON string.
+
+## [0.3.0] - 2026-05-17
+
+### Added
+
+- **Connection retries** via `httpx.AsyncHTTPTransport(retries=3)` for
+  DNS / TCP / TLS handshake failures.
+- **HTTP retries with exponential backoff + jitter** for 429 and 5xx
+  responses (cap 5 s, configurable). 4xx are not retried.
+- **Async-safe TTL cache** (`thruk_mcp.cache.TTLCache`, default 15 s)
+  wired to slow-moving endpoints: `/sites`, `/processinfo`,
+  `/*/stats`, `/*/totals`, `/contacts`, `/contactgroups`,
+  `/timeperiods`, `/commands`. Per-call override via `cache_ttl=`.
+- **`ThrukClient.get_all()`** — async paginator over a list endpoint
+  using `limit`/`offset`, with `hard_limit` safety net (default 50k).
+- **`ThrukClient.run_background()`** + new tool
+  `thruk_run_background_query` — wrap Thruk's `?background=1` flow
+  and poll `/thruk/jobs/<id>/output` (302 vs. 200) until completion.
+- **5 MCP Resources** — `thruk://hosts/{name}`,
+  `thruk://services/{host}/{service}`, `thruk://hostgroups/{name}`,
+  `thruk://problems`, `thruk://stats`. Clients with a resource browser
+  (Claude Desktop, VS Code, ...) can open Thruk objects like files.
+- **3 MCP Prompts** — `investigate_alert(host, service?)`,
+  `schedule_maintenance(target, duration_minutes, kind)`,
+  `diagnose_flapping(host, service)`. Pre-canned slash-commands for
+  the most common ops workflows.
+- 12 new tests (cache TTL semantics, get_all pagination, retry on
+  503/4xx, cache hit). Suite now 15 passing.
+
+### Changed
+
+- README rewritten: \"What is exposed\" section (29 tools / 5 resources /
+  3 prompts) and \"Robustness\" section. The stale v0.1 tools table was
+  removed.
+
+## [0.2.0] - 2026-05-17
+
+### Added
+
+- **Log / history tools** for incident investigation:
+  `thruk_list_logs`, `thruk_list_alerts`, `thruk_list_notifications`,
+  `thruk_recent_events`, `thruk_get_downtime`.
+- **Comprehensive downtime management**:
+  `thruk_schedule_host_services_downtime` (all services of a host),
+  `thruk_schedule_propagated_host_downtime` (parent + child hosts, optionally
+  triggered), `thruk_schedule_hostgroup_downtime`,
+  `thruk_schedule_servicegroup_downtime`,
+  `thruk_delete_active_downtimes`, `thruk_delete_downtimes_by_filter`
+  (bulk delete via `del_downtime_by_{host_name,hostgroup_name,start_time_comment}`).
+- **Pagination, sort and tight default columns** on every list-style tool:
+  new `offset`, `sort`, `columns` arguments. Module-level
+  `DEFAULT_*_COLUMNS` constants document the curated subsets. Pass
+  `columns=""` to opt out and get every column (v0.1 behaviour).
+- Unit tests for `_list_params` (8 passing tests total).
+
+### Changed
+
+- All list tools (`thruk_list_hosts`, `thruk_list_services`,
+  `thruk_list_hostgroups`, `thruk_list_servicegroups`, `thruk_problems`,
+  `thruk_list_downtimes`, `thruk_list_comments`, plus the 4 log-family
+  tools) now return a tight default subset of columns to dramatically
+  reduce LLM token consumption. **Breaking** for callers that relied on
+  every field being returned: pass `columns=""` to restore.
+- `limit` is now clamped to `1..1000` on every list tool.
+
+### Fixed
+
+- `thruk_acknowledge` payload keys corrected to match the Thruk REST
+  contract (`sticky_ack`, `send_notification`, `persistent_comment`).
+  The previous keys (`sticky`, `notify`, `persistent`) were silently
+  ignored by the core, meaning the `notify=False` flag never actually
+  suppressed notifications.
+
+## [0.1.0] - 2026-05-17
+
+### Added
+
+- Initial release.
+- 17 MCP tools for the Thruk REST API: hosts, services, groups,
+  downtimes (schedule/delete), comments, sites, stats, problems,
+  acknowledge / remove ack, force recheck, plus a `thruk_query`
+  escape hatch for any other endpoint.
+- Async `httpx` client with native multi-backend (federated Thruk
+  sites) support.
+- Two transports: stdio (default) and Streamable-HTTP (`--listen PORT`).
+- Multi-stage Dockerfile, non-root user, ghcr.io publishing on tag.
+- Docker MCP Gateway compatibility (`catalog/server.yaml`,
+  `catalog/tools.json`, stdio default).
+- GitHub Actions CI (ruff + pytest matrix on 3.10/3.11/3.12 + Docker
+  build) and release workflow (multi-arch image with provenance + SBOM).
+
+[Unreleased]: https://github.com/k9fr4n/thruk-mcp/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/k9fr4n/thruk-mcp/compare/v0.5.0...v1.0.0
+[0.5.0]: https://github.com/k9fr4n/thruk-mcp/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/k9fr4n/thruk-mcp/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/k9fr4n/thruk-mcp/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/k9fr4n/thruk-mcp/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/k9fr4n/thruk-mcp/releases/tag/v0.1.0

thruk_mcp-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing
+
+Thanks for considering a contribution! This project is small enough that the
+rules can fit on one page.
+
+## Quick setup
+
+```bash
+git clone https://github.com/k9fr4n/thruk-mcp.git
+cd thruk-mcp
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+```
+
+Run the full checks the way CI does:
+
+```bash
+ruff check src tests
+ruff format --check src tests
+mypy src
+pytest -v --cov=thruk_mcp --cov-fail-under=80
+```
+
+## Branching and PR flow
+
+- **No direct push to `main`.** All changes go through a PR.
+- Branch prefixes: `feat/`, `fix/`, `chore/`, `docs/`, `refactor/`, `test/`.
+- We squash-merge. Make your commit message look like the final PR title.
+- PR titles follow [Conventional Commits](https://www.conventionalcommits.org/):
+  `feat(server): ...`, `fix(client): ...`, `chore(ci): ...`, etc.
+
+## Adding a new MCP tool
+
+1. Define the tool in `src/thruk_mcp/server.py` inside `build_server()`.
+   - Use `snake_case` and the `thruk_` prefix.
+   - Type every parameter; no `**kwargs`.
+   - Docstring is LLM-facing — keep it concise and unambiguous.
+   - Surface `ThrukError` messages verbatim; never swallow them.
+2. **List tools must** accept `limit`, `offset`, `sort`, `columns` and use
+   `_list_params()` + a `DEFAULT_*_COLUMNS` constant.
+3. **Write tools must** be added to `WRITE_TOOLS` in `server.py` so that
+   `THRUK_READ_ONLY` and the audit log apply to them.
+4. Add an entry in `catalog/tools.json` (one line per tool).
+5. Add a `respx`-mocked routing test in `tests/test_tools.py` asserting the
+   method, URL path and key params.
+6. Run the checks listed above. Coverage gate is **80 %**.
+
+## Adding a new env var
+
+Any new `THRUK_*` env var must appear in three places (the CI does not enforce
+this but reviewers will):
+
+- `src/thruk_mcp/config.py` — added as a field on `ThrukConfig` and parsed in
+  `from_env()`.
+- `.env.example` — with a comment describing it.
+- `catalog/server.yaml` — in `config.env` *and* `config.parameters` so the
+  Docker MCP Toolkit UI can render it.
+
+## Releasing (maintainers)
+
+1. Open a `chore/release-X.Y.Z` branch.
+2. Bump `version` in `pyproject.toml` and `__version__` in
+   `src/thruk_mcp/__init__.py`.
+3. Add a `CHANGELOG.md` section dated to release day, plus a new compare
+   link at the bottom.
+4. Note any breaking change in `UPGRADING.md`.
+5. PR → review → squash merge.
+6. From `main`: `git tag -a vX.Y.Z -m '...'` then `git push origin vX.Y.Z`.
+7. `gh release create vX.Y.Z --title '...' --notes '...'`.
+
+The tag triggers `.github/workflows/release.yml` which builds and pushes
+`ghcr.io/k9fr4n/thruk-mcp:{X.Y.Z,X.Y,latest}` (multi-arch, provenance, SBOM).
+
+## Reporting bugs
+
+Open an issue with:
+
+- Thruk version (`/thruk/r/processinfo`)
+- `thruk-mcp --help` (covers version + transport mode)
+- The exact tool call that misbehaved and the error message
+- Whether the same call works with `curl` against Thruk
+
+## Code of conduct
+
+Be respectful. Disagreements are fine, personal attacks are not.

thruk_mcp-1.0.0/Dockerfile

@@ -0,0 +1,20 @@
+# syntax=docker/dockerfile:1.7
+FROM python:3.12-slim AS build
+WORKDIR /src
+RUN pip install --no-cache-dir build
+COPY pyproject.toml README.md ./
+COPY src ./src
+RUN python -m build --wheel --outdir /dist
+
+FROM python:3.12-slim
+RUN useradd -r -u 1001 -m thruk
+WORKDIR /app
+COPY --from=build /dist/*.whl /tmp/
+RUN pip install --no-cache-dir /tmp/*.whl && rm -f /tmp/*.whl
+USER thruk
+ENV PYTHONUNBUFFERED=1
+# Default = stdio transport (Docker MCP Gateway / Claude Desktop / LibreChat).
+# For HTTP/Streamable-HTTP, override CMD: ["--listen", "8001"]
+EXPOSE 8001
+ENTRYPOINT ["thruk-mcp"]
+CMD []

thruk_mcp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franck SALLET
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.