Skip to content

v0.4.0 — MCP Auth Server Template

Choose a tag to compare

@brunovicco brunovicco released this 09 Aug 21:15
· 14 commits to main since this release
e0a7065

v0.4.0 — MCP Auth Server Template

v0.4.0 makes observability a real, shared client/server boundary and makes the repository easier
to evaluate before adoption.

Use this release with mcp-client-auth-template v0.4.0 for the tested cross-repository profile.

Highlights

  • a2a-otel-kit[mcp] 0.6 at the production MCP Streamable HTTP ASGI boundary.
  • Metadata-only W3C trace-context continuation shared with the companion client.
  • Hardened HTTP admission remains outside tracing; authentication and tool dispatch remain inside.
  • Deterministic observability shutdown through the MCP server lifespan.
  • Removal of the disconnected local OpenTelemetry lifecycle and duplicate sanitization policy.
  • Reworked English and Brazilian Portuguese READMEs for developers, technical leaders, and
    engineering reviewers.

Security and privacy

  • Observability remains network-silent unless explicitly enabled with A2A_OTEL_ENABLED=true and
    a complete OTLP traces endpoint.
  • Spans never capture authorization data, arbitrary headers or URLs, MCP arguments/results,
    request/response bodies, baggage, or exception text.
  • Trace context remains correlation metadata and never participates in authentication or
    authorization.
  • The server continues to validate issuer, audience, signature, expiry, identity class, and scopes
    before tool dispatch.

Upgrade notes

  • Install the normal locked dependency set with uv sync --frozen --all-groups; the old
    observability extra no longer exists.
  • Replace the previous OTEL_* examples with the documented A2A_OTEL_* settings if tracing is
    enabled in your deployment.
  • Disabled observability remains a no-op with no exporter, worker, or telemetry network request.

Compatibility

  • Python: >=3.13,<3.15
  • MCP Python SDK: >=2.0,<3
  • MCP SDK tested floor: 2.0.0
  • MCP protocol reference: 2026-07-28
  • Transport: Streamable HTTP
  • Authentication: Microsoft Entra ID and generic OIDC
  • Companion release: mcp-client-auth-template v0.4.0

Validation

  • Complete quality and security gate: 210 tests, 88.98% coverage
  • Python 3.13 and 3.14 compatibility matrix
  • MCP SDK 2.0.0 and latest compatible 2.x
  • Container smoke and Kubernetes manifest checks
  • Canonical cross-repository contract and companion OAuth/MCP E2E suite