domotz-mcp/CHANGELOG.md

MCP server for Domotz API and BMS (Building Management System) integration with IoT device monitoring

# Changelog

All notable changes to the Domotz MCP Server will be documented in this file.

## [0.1.0] - 2025-06-16

### Added
- **Major Feature**: Persistent MQTT message storage using SQLite database
- New `mqtt_query` tool for querying stored MQTT messages with filtering by topic, time range, and connection
- New `mqtt_subscriptions` tool for managing subscriptions and database settings
- Automatic message storage for all persistent subscriptions
- Configurable message retention policy (default: 7 days)
- Database statistics and monitoring capabilities
- Support for MQTT wildcard pattern matching in queries

### Changed
- Completely redesigned `mqtt_subscribe` tool with persistent storage by default
- Added `persistent` parameter to mqtt_subscribe (defaults to true)
- Subscriptions now continue collecting messages in the background
- Messages are automatically stored in SQLite database for later retrieval

### Fixed
- Fixed MQTT topic pattern matching for wildcards (+ and #)
- Improved subscription management and cleanup

## [0.0.25] - 2025-06-16

### Fixed
- Fixed error response handling in MQTT tools to prevent validation errors
- Changed Promise rejections to resolved error responses to comply with MCP protocol
- Added automatic protocol detection for MQTT broker URLs
- Added debug logging for MQTT connection attempts

### Changed
- Improved error handling to return proper JSON responses instead of throwing errors
- Added URL validation and protocol prefixing for MQTT connections

## [0.0.24] - 2025-06-16

### Fixed
- Fixed MQTT and Home Assistant tool registration issues
- All tools now properly extend MCPTool base class
- Updated tool schemas to use Zod validation
- Resolved "Invalid tool found: missing required properties" warnings

### Changed
- Migrated MQTT tools (mqtt_connect, mqtt_publish, mqtt_subscribe) to use MCPTool base class
- Migrated Home Assistant tools (ha_discover, ha_control) to use MCPTool base class
- Improved consistency across all tool implementations

## [0.0.23] - 2025-06-16

### Added
- Published package to npm registry
- Made available via npx execution

## [0.0.22] - 2025-01-15

### Changed
- Updated documentation with complete MCP configuration examples
- Added environment variable placeholders for MQTT and Home Assistant
- Clarified optional vs required configuration parameters
- Updated USAGE.md with comprehensive setup instructions

## [0.0.21] - 2025-01-15

### Added
- MQTT Integration:
  - `mqtt_connect`: Connect to MQTT brokers with authentication support
  - `mqtt_subscribe`: Subscribe to topics with wildcard support and QoS levels
  - `mqtt_publish`: Publish messages to control IoT devices
- Home Assistant Integration:
  - `ha_discover`: Discover all entities, devices, and areas in Home Assistant
  - `ha_control`: Control Home Assistant entities (lights, switches, climate, etc.)
- Extended IoT device management capabilities
- Support for real-time data streaming via MQTT
- Comprehensive examples for MQTT and Home Assistant usage

### Changed
- Updated README with IoT integration features section
- Added new keywords: mqtt, home-assistant, smart-home

## [0.0.20] - 2025-01-15

### Changed
- Updated package description to mention BMS and IoT monitoring
- Added BMS and IoT-related keywords
- Updated README to clarify BMS features and experimental status

## [0.0.19] - 2025-01-15

### Added
- BMS (Building Management System) integration tools:
  - `bms_connect`: Connect to BMS controllers and discover data points
  - `bms_monitor`: Continuous monitoring with historical data tracking
- Support for multiple BMS controller types (Trend Controls, Honeywell, Johnson Controls)
- HTTP/HTTPS protocol support for web-based BMS interfaces
- Experimental BACnet and Modbus protocol support (requires further development)
- Historical data storage for monitored data points (last 1000 records)
- Automatic alarm detection and status tracking
- Dashboard server for BMS monitoring visualization

### Changed
- Extended MCP server capabilities beyond Domotz API to include IoT/BMS integration

## [0.0.18] - 2025-01-15

### Added
- Command-line argument support for API key (`--api-key=`)

### Fixed
- Version number consistency in index.ts

## [0.0.16-0.0.17] - 2025-01-15

### Fixed
- Various MCP protocol compatibility improvements
- Tool parameter handling

## [0.0.15] - 2025-01-15

### Fixed
- Fixed version mismatch in index.ts (was hardcoded to 0.0.13)
- Server now properly declares tools capability
- Fixed TypeScript compilation issues
- Resolved MCP client connection issues

### Added
- Added comprehensive test scripts for MCP server validation
- Added USAGE.md documentation
- Added .npmignore to exclude unnecessary files from npm package

### Changed
- Updated all tools to use consistent parameter types (string instead of number)
- Improved error handling in tools
- Enhanced logging for better debugging

## [0.0.14] - 2025-01-15

### Fixed
- Initial fixes for MCP server compatibility

## [0.0.13] - 2025-01-15

### Added
- Initial release with Domotz API integration
- Basic tools for agent management and data retrieval
- Core Domotz API integration tools:
  - `get_all_agents`: List all Domotz agents with pagination
  - `get_agent`: Get specific agent details
  - `get_domotz_data`: Generic API endpoint access
  - `bind_webhook`: Configure webhook notifications

## [0.0.12] - 2025-01-14

### Fixed
- Tool discovery issues with mcp-framework
- Error handling improvements

## [0.0.11] - 2025-01-14

### Changed
- Migrated to mcp-framework for automatic tool discovery
- Improved project structure

## [0.0.10] - 2025-01-14

### Fixed
- Package configuration for npm distribution
- Executable permissions

## [0.0.9] - 2025-01-14

### Added
- `bin` field to package.json to enable `npx` execution

### Fixed
- Package executable configuration

## [0.0.8] - 2025-01-14

### Fixed
- Server initialization issue with mcp-framework
- Removed example tool

### Changed
- Improved error handling

## [0.0.7] - 2025-01-13

### Added
- Initial release with basic Domotz API integration
- MCP server implementation using stdio transport
- Environment variable configuration for API credentials