> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-server-langgraph.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Version History

> Complete release history and version comparison for MCP Server with LangGraph

## Current Version

**Latest Release**: v2.8.0 (2025-10-22)
**Highlights**: Test Coverage +35% (85%+ overall), Docker-based integration testing infrastructure, 61 new comprehensive test cases

## Version Comparison Matrix

| Feature                       |   v2.8   |   v2.7  |   v2.6  |   v2.5  |   v2.4  |   v2.3  |   v2.2  |  v2.1  |
| ----------------------------- | :------: | :-----: | :-----: | :-----: | :-----: | :-----: | :-----: | :----: |
| **Authentication & Sessions** |          |         |         |         |         |         |         |        |
| Keycloak SSO Integration      |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Redis Session Management      |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Session Store Architecture    |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Provider Pattern              |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| **Compliance & Security**     |          |         |         |         |         |         |         |        |
| GDPR Data Subject Rights      |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌   |
| SOC 2 Automation              |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌   |
| HIPAA Technical Safeguards    |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌   |
| SLA Monitoring (99.9%)        |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌   |
| Data Retention Policies       |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌   |
| Compliance Storage Backend    |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌    |    ❌   |
| **Testing & Quality**         |          |         |         |         |         |         |         |        |
| Unit Tests (498+)             |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Integration Tests             |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Docker Integration Tests      |     ✅    |    ✅    |    ✅    |    ✅    |    ❌    |    ❌    |    ❌    |    ❌   |
| 100% Test Pass Rate           |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ❌    |    ❌    |    ❌   |
| Property-Based Testing        |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Contract Testing              |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Test Coverage                 | **85%+** |  \~75%  |  \~75%  |  \~75%  |  \~75%  |  \~75%  |  \~75%  |  \~75% |
| **Documentation**             |          |         |         |         |         |         |         |        |
| Mintlify Docs                 |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Architecture Decision Records |  30 ADRs | 30 ADRs | 26 ADRs | 21 ADRs | 21 ADRs | 21 ADRs |  5 ADRs | 5 ADRs |
| **Core Features**             |          |         |         |         |         |         |         |        |
| LangGraph Version             |  0.6.10  |  0.6.10 |  0.6.10 |  0.6.10 |  0.6.10 |  0.2.28 |  0.2.28 | 0.2.28 |
| Multi-LLM Support (LiteLLM)   |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| OpenFGA Authorization         |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Pydantic Version              |    V2    |    V2   |    V2   |    V2   |    V2   |    V2   |    V1   |   V1   |
| Type Safety Coverage          |    64%   |   64%   |   64%   |   64%   |   64%   |   64%   |   27%   |   27%  |
| Agentic Loop (GAVR)           |     ✅    |    ✅    |    ❌    |    ❌    |    ❌    |    ❌    |    ❌    |    ❌   |
| Anthropic Best Practices      |  9.8/10  |  9.8/10 |    ❌    |    ❌    |    ❌    |    ❌    |    ❌    |    ❌   |
| **Secrets Management**        |          |         |         |         |         |         |         |        |
| Infisical Integration         |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Infisical Docker Builds       |     ✅    |    ✅    |    ✅    |    ✅    |    ❌    |    ❌    |    ❌    |    ❌   |
| 5 Installation Options        |     ✅    |    ✅    |    ✅    |    ✅    |    ❌    |    ❌    |    ❌    |    ❌   |
| **Deployment**                |          |         |         |         |         |         |         |        |
| Kubernetes/Helm/Kustomize     |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Multi-Cloud (GKE/EKS/AKS)     |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Docker Compose                |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| **Observability**             |          |         |         |         |         |         |         |        |
| OpenTelemetry + LangSmith     |     ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅    |    ✅   |
| Grafana Dashboards            |     9    |    9    |    9    |    9    |    9    |    9    |    9    |    7   |
| Prometheus Alerts             |  20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA | 20+ SLA |  Basic |

## Release Highlights

<CardGroup cols={2}>
  <Card title="v2.8.0 - Test Coverage Boost" icon="flask" href="/releases/v2-8-0">
    Test coverage +35% (85%+) + Infrastructure improvements
  </Card>

  <Card title="v2.7.0 - Agentic AI Ready" icon="wand-magic-sparkles" href="/releases/v2-7-0">
    Agentic loop + Anthropic best practices (9.8/10)
  </Card>

  <Card title="v2.6.0 - CI/CD Hardening" icon="rocket" href="/releases/v2-6-0">
    CI/CD fixes + Documentation improvements
  </Card>

  <Card title="v2.5.0 - Integration Testing" icon="flask" href="/releases/v2-5-0">
    Docker integration tests + Infisical builds
  </Card>

  <Card title="v2.4.0 - LangGraph Upgrade" icon="check" href="/releases/v2-4-0">
    LangGraph 0.6.10 + 100% test pass rate
  </Card>

  <Card title="v2.3.0 - Type Safety" icon="database" href="/releases/v2-3-0">
    Storage backend + Pydantic V2
  </Card>

  <Card title="v2.2.0 - Enterprise Compliance" icon="shield-halved" href="/releases/v2-2-0">
    GDPR/SOC2/HIPAA compliance automation
  </Card>

  <Card title="v2.1.0 - Production Ready" icon="key" href="/releases/v2-1-0">
    Keycloak SSO + Production hardening
  </Card>

  <Card title="v2.0.0 - Major Restructure" icon="cube" href="https://github.com/vishnu2kmohan/mcp-server-langgraph/releases/tag/v2.0.0">
    Package reorganization (breaking)
  </Card>
</CardGroup>

## Version Timeline

```mermaid theme={null}
%% ColorBrewer2 Set3 palette - each component type uniquely colored
flowchart LR
    V1[v1.0.0<br/>Initial Release] --> V2[v2.0.0<br/>Package Reorg]
    V2 --> V21[v2.1.0<br/>Keycloak + Redis]
    V21 --> V22[v2.2.0<br/>Compliance Suite]
    V22 --> V23[v2.3.0<br/>Storage + Types]
    V23 --> V24[v2.4.0<br/>LangGraph 0.6.10]
    V24 --> V25[v2.5.0<br/>Docker Tests]
    V25 --> V26[v2.6.0<br/>CI/CD Fixes]
    V26 --> V27[v2.7.0<br/>Agentic Loop]
    V27 --> V28[v2.8.0<br/>Test Coverage 85%+]

    %% ColorBrewer2 Set3 palette - progressive version timeline

```

## Migration Guides

<AccordionGroup>
  <Accordion title="v2.7.0 → v2.8.0 (Latest)">
    **Breaking Changes**: None

    **New Features**:

    * Test coverage improvements (+35% overall, now 85%+)
    * Docker Compose test environment (Qdrant, Redis, PostgreSQL)
    * 61 new comprehensive test cases
    * 25 previously-skipped tests now enabled

    **Recommended Actions**:

    1. Update dependencies: `uv sync`
    2. Run tests with new Docker infrastructure: `make test-integration`
    3. Review new test coverage reports
    4. Update CI/CD to use Docker Compose test environment
  </Accordion>

  <Accordion title="v2.3.0 → v2.4.0">
    **Breaking Changes**: None

    **New Features**:

    * LangGraph 0.6.10 (API compatible)
    * 100% test pass rate (437/437)
    * 21 comprehensive ADRs

    **Recommended Actions**:

    1. Update dependencies: `uv sync`
    2. Run tests: `make test`
    3. Review new ADRs for architectural guidance
  </Accordion>

  <Accordion title="v2.2.0 → v2.3.0">
    **Breaking Changes**: None (Pydantic V2 backward compatible)

    **New Features**:

    * Compliance storage backend (5 interfaces)
    * Pydantic V2 migration
    * Type safety enhanced (27% → 64%)

    **Recommended Actions**:

    1. Review Pydantic V2 changes if extending models
    2. Run type checks: `mypy src/`
    3. Test compliance storage integration
  </Accordion>

  <Accordion title="v2.1.0 → v2.2.0">
    **Breaking Changes**: None

    **New Features**:

    * GDPR/SOC2/HIPAA compliance automation
    * SLA monitoring with 20+ Prometheus alerts
    * 2 new Grafana dashboards

    **Recommended Actions**:

    1. Configure compliance settings in `.env`
    2. Import new Grafana dashboards
    3. Review Prometheus alert rules
    4. Set up data retention policies
  </Accordion>

  <Accordion title="v2.0.0 → v2.1.0">
    **Breaking Changes**: None (v2.0.0 was the breaking change)

    **New Features**:

    * Keycloak SSO integration
    * Redis session management
    * Kubernetes/Helm deployment infrastructure
    * 43 MDX documentation files

    **Recommended Actions**:

    1. Set up Keycloak if using SSO: `make setup-keycloak`
    2. Configure Redis for sessions
    3. Review Kubernetes deployment guides
  </Accordion>

  <Accordion title="v1.x → v2.0.0">
    **Breaking Changes**: ⚠️ Major package reorganization

    **Import Path Changes**:

    ```python theme={null}
    # Before (v1.x)
    from config import settings
    from auth import AuthMiddleware

    # After (v2.x)
    from mcp_server_langgraph.core.config import settings
    from mcp_server_langgraph.auth.middleware import AuthMiddleware
    ```

    **Recommended Actions**:

    1. Update all imports to new structure
    2. Review migration guide in CHANGELOG
    3. Update CI/CD pipelines
    4. Test thoroughly before deploying
  </Accordion>
</AccordionGroup>

## Deprecation Schedule

| Feature            | Deprecated In | Removed In | Alternative              |
| ------------------ | ------------- | ---------- | ------------------------ |
| HTTP/SSE Transport | v2.0.0        | v2.0.0     | StreamableHTTP transport |
| Pydantic V1        | v2.3.0        | v3.0.0     | Pydantic V2 models       |

## Semantic Versioning

This project follows [Semantic Versioning 2.0.0](https://semver.org/):

* **MAJOR** (v2.x.x): Breaking changes (import paths, API changes)
* **MINOR** (vx.Y.x): New features (backward compatible)
* **PATCH** (vx.x.Z): Bug fixes (backward compatible)

## Support Policy

| Version | Status      | Support Until | Security Fixes |
| ------- | ----------- | ------------- | -------------- |
| v2.8.x  | **Current** | Active        | ✅ Yes          |
| v2.7.x  | Maintenance | 2026-04-22    | ✅ Yes          |
| v2.6.x  | Maintenance | 2026-01-17    | ✅ Yes          |
| v2.5.x  | End of Life | 2025-10-20    | ❌ No           |
| v2.4.x  | End of Life | 2025-10-14    | ❌ No           |
| v2.3.x  | End of Life | 2025-04-13    | ❌ No           |
| v2.2.x  | End of Life | 2025-04-13    | ❌ No           |
| v2.1.x  | End of Life | 2025-04-12    | ❌ No           |
| v2.0.x  | End of Life | 2025-02-11    | ❌ No           |
| v1.x    | End of Life | 2025-01-10    | ❌ No           |

## Getting Help

<CardGroup cols={2}>
  <Card title="CHANGELOG" icon="newspaper" href="https://github.com/vishnu2kmohan/mcp-server-langgraph/blob/main/CHANGELOG.md">
    Detailed release notes
  </Card>

  <Card title="GitHub Releases" icon="github" href="https://github.com/vishnu2kmohan/mcp-server-langgraph/releases">
    Download specific versions
  </Card>

  <Card title="Discussions" icon="comments" href="https://github.com/vishnu2kmohan/mcp-server-langgraph/discussions">
    Community support
  </Card>

  <Card title="Issues" icon="bug" href="https://github.com/vishnu2kmohan/mcp-server-langgraph/issues">
    Report bugs
  </Card>
</CardGroup>
