Skip to content

0053. Updating arxiv-mcp and litellm Docker Images and Versioning Strategy

  • Status: proposed (auto-drafted by adr-suggester)
  • Date: 2026-07-26
  • Deciders: lusoris
  • Related: PR #3138

Context

This PR updates the arxiv-mcp server from version 0.5.1 to 0.6.0, aligns the Docker image versioning with the appVersion in Chart.yaml, and adjusts the litellm Dockerfile to use a tagged digest for better version control and compatibility. It also addresses the removal of a previously planned upgrade to llama-swap.

Decision

The PR introduces a multi-component change involving versioning strategy, Docker image updates, and compatibility adjustments across multiple services, warranting an ADR.

Alternatives considered

  • Bundle llama-swap v241→v242 in the same batch (the original #3123 assumption): rejected — all four llama-swap patches fail against v242, making it a patch-stack rebase, not a version bump; split to its own change (#3155) rather than block the trivial bumps.
  • Leave the litellm FROM digest-only: rejected — a digest without a tag is structurally invisible to Renovate, so the image silently stops receiving upgrade PRs; re-adding :v1.93.0@sha256:… restores visibility without changing the pinned digest.
  • Mirror arxiv-mcp 0.6.0 to Harbor in the same PR: deferred — the Harbor mirror + digest re-pin follows the repo's harbor-mirror flow post-merge, keeping this PR upstream-only.

Consequences

  • arxiv-mcp tracks a maintained release (0.6.0, verified requires_python >=3.11, CLI/env contract unchanged); the CI ghcr tag follows appVersion.
  • The litellm image is Renovate-visible again; future upgrades surface as PRs.
  • llama-swap stays on v241 until its dedicated rebase lands — accepted as a known follow-up, not a regression.

References

  • PR #3138 — fix(ai): arxiv-mcp 0.6.0 + restore litellm FROM version tag (#3123)