🚨 Critical Hotfix Release
PRODUCTION BLOCKER FIXED: This release resolves a critical issue that prevented the HTTP server from starting in v8.36.0.
Issue Fixed
HTTP Server Crash on Startup (issue #247)
- Severity: Critical (blocks HTTP server startup)
- Affected Version: v8.36.0
- Impact: All v8.36.0 users experiencing immediate startup failures
Root Cause
PR #244's code quality refactoring introduced forward type references in analytics.py without the required from __future__ import annotations import. This caused Python's type checker to fail when encountering forward references like tuple[str, int] before Python 3.10.
Fix Details
# Added to src/mcp_memory_service/web/api/analytics.py
from __future__ import annotations
from typing import Tuple # Python 3.9 compatibilityWhat Changed
- ✅ Added
from __future__ import annotationsto enable forward references - ✅ Added
Tupleto typing imports for Python 3.9 compatibility - ✅ HTTP server now starts successfully
- ✅ All 10 analytics routes register correctly
Testing & Verification
Verified on:
- ✅ Python 3.9, 3.10, 3.11, 3.12
- ✅ HTTP server startup (
uv run python scripts/server/run_http_server.py) - ✅ Health endpoint returns correct version
- ✅ Analytics endpoints functional
- ✅ No regression in existing functionality
Upgrade Instructions
For v8.36.0 users experiencing startup failures:
# Update to v8.36.1
pip install --upgrade mcp-memory-service
# Or with uv
uv pip install --upgrade mcp-memory-service
# Verify version
python -c "import mcp_memory_service; print(mcp_memory_service.__version__)"
# Should output: 8.36.1
# Test HTTP server
uv run python scripts/server/run_http_server.py
# Should start without errorsFor users on v8.35.0 or earlier:
- No action required if not experiencing issues
- Recommended to upgrade when convenient for code quality improvements
Breaking Changes
None - This is a pure bug fix release.
Timeline
- Reported: 2025-11-24 (shortly after v8.36.0 release)
- Fixed: 2025-11-24 (commit bc90aec)
- Released: 2025-11-24 (v8.36.1)
- Turnaround: ~30 minutes from report to release
Related Issues
- Fixes #247 - HTTP server crash on v8.36.0 startup
Credits
Thank you to the community for the rapid bug report that enabled this fast hotfix!
Additional Resources
Full Changelog: v8.36.0...v8.36.1