v0.2.0 (PREMATURE - Use v0.1.4 Instead)

🚨 IMPORTANT: This Release Was Published Prematurely

This v0.2.0 release was published before all intended features and test coverage were complete.

Please use v0.1.4 instead, which contains identical code but the correct version number.

The true v0.2.0 release will be published later when:

• Zone-Based Firewall implementation is complete (~60% done as of 2025-11-17)
• Traffic Flow monitoring is fully implemented (~100% done as of 2025-11-17)
• Advanced QoS and traffic management is added
• Backup and restore operations are implemented
• Test coverage reaches 80%+ target (currently 34%)

See DEVELOPMENT_PLAN.md for the full roadmap.

---

Original Release Notes (For Reference)

What's Changed

• chore: release v0.2.0 (b79c7ef)
• fix: add missing ValidationError import to Site model tests (259f21b)
• Update tests/unit/test_models_site.py (92010fc)
• fix: resolve Cloud API schema mismatch in Site model (issue #3) (e56b0b5)
• style: format WiFi test imports per isort pre-commit requirements (bd0b5ad)
• fix: remove unused ConfirmationRequiredError import from WiFi tests (e21ec35)
• fix: resolve all WiFi test failures (23/23 passing) (ed384e0)
• fix: resolve Ruff linting errors in WiFi test suite (20aed32)
• style: format traffic_flows.py with Black (b4d77f0)
• fix: resolve Python 3.10 compatibility and import sorting issues (e6dfe18)
• fix: resolve CI failures in WiFi test suite (bb4ce33)
• test: add comprehensive WiFi tools test suite (50.85% coverage) (39c6b8e)

Full Changelog: v0.1.3...v0.2.0

Docker Image

# ⚠️ Please use v0.1.4 instead
docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.4

Installation

# ⚠️ Please use v0.1.4 instead
pip install unifi-mcp-server==0.1.4

Release v0.1.4

🔄 Version Correction Notice

This release contains the same code as v0.2.0, which was published prematurely on 2025-11-17. v0.1.4 is the correct version number for this release. Please use v0.1.4 instead of v0.2.0.

The true v0.2.0 release is planned for Q1 2025 and will include:

• Complete Zone-Based Firewall (ZBF) implementation
• Full Traffic Flow monitoring
• Advanced QoS and traffic management
• Backup and restore operations
• 80%+ test coverage

See DEVELOPMENT_PLAN.md for the complete roadmap.

---

What's Changed

Fixed

• GitHub Issue #3: Cloud API schema mismatch in Site model
  • Fixed Pydantic validation errors when using Cloud API
  • Site model now accepts siteId (Cloud) and _id (Local) field names
  • Site model now accepts siteName and name field variations
  • Added model_validator to generate fallback names from site IDs
• All 16 failing WiFi tests resolved (23/23 now passing)
  • Fixed mock return value structures to match UniFi API response format
  • Added missing security parameter to WLAN creation tests
  • Changed exception types from ConfirmationRequiredError to ValidationError
  • Fixed missing API call mocks for update/delete operations
  • Fixed field name assertions (passphrase → x_passphrase)
  • Rewrote statistics tests to handle dual API calls correctly
• Python 3.10 compatibility issues resolved
• Import sorting issues fixed per isort/pre-commit requirements
• Ruff linting errors in WiFi test suite resolved
• Missing ValidationError import added to Site model tests
• Traffic flows formatting with Black

Added

• Comprehensive WiFi tools test suite with 23 tests and 70.34% coverage
• Cloud API compatibility for Site model using Pydantic v2 validation_alias
• Support for both Cloud API (siteId, isOwner) and Local API (_id, name) schemas
• 17 comprehensive unit tests for Site model covering Cloud/Local API compatibility
• Automatic name fallback generation for Cloud API sites without explicit names

Changed

• Site model made backward compatible with existing Local API code
• Enhanced Site model with Cloud API-specific fields (is_owner)
• Improved test coverage from 36.83% to 41.27% overall
• Site model test coverage: 100%

Technical Details

• All 228 tests passing
• Test coverage: 41.27%
• CI/CD pipelines: All checks passing
• Compatible with Python 3.10, 3.11, 3.12

Full Changelog: v0.1.3...v0.1.4

Docker Image

docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.4

Installation

Via pip

pip install unifi-mcp-server==0.1.4

Via uv

uv pip install unifi-mcp-server==0.1.4

Release v0.1.2

What's Changed

• fix(docker): add mcp.run() call and update Docker instructions (41f3cfe)

Full Changelog: v0.1.1...v0.1.2

Docker Image

docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.2

Installation

Via pip

pip install unifi-mcp-server==v0.1.2

Via uv

uv pip install unifi-mcp-server==v0.1.2

Release v0.1.1

What's Changed

• fix(security): update secrets baseline to include false positives (fec7965)
• fix(ci): resolve pre-commit hook failures and FastMCP initialization (f7e2663)
• Updating README.md (c258f70)
• Updating README.md (8bc6df4)
• fix(security): install OSV scanner binary directly instead of using action (e4cab65)

Full Changelog: v0.1.0...v0.1.1

Docker Image

docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.1

Installation

Via pip

pip install unifi-mcp-server==v0.1.1

Via uv

uv pip install unifi-mcp-server==v0.1.1

Release v0.1.0

What's Changed

Initial Release

Full Changelog: ...v0.1.0

Docker Image

docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.0

Installation

Via pip

pip install unifi-mcp-server==v0.1.0

Via uv

uv pip install unifi-mcp-server==v0.1.0