Tags

v3.0.0

Release v3.0.0: Container Management & Network Testing

Major Features:
- Container Network Testing Tool (Issue #13)
- Container Log Retrieval System (Issue #12)
- Advanced Container Diagnostics (Issue #11)
- Enhanced Container Health Listing (Issue #10)
- Complete Docker API Service Integration (Issue #9)

This release focuses on comprehensive container management capabilities with advanced network testing, log analysis, health monitoring, and robust Docker API integration using Effect.ts service patterns.

v2.0.0

Release version 2.0.0

Major release with Docker API integration, enhanced type safety, and new tools.

Key features:
- Docker API integration with branded types
- CPU bottleneck analysis and memory pressure tools
- System overview tool with comprehensive monitoring
- Unified transport architecture
- Enhanced error handling with Effect.ts patterns
- Option<T> migration for better null safety

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

v1.0.1

Release v1.0.1: Fix HTTP response delivery timeout

This patch release fixes a critical issue where HTTP endpoints would timeout
despite appearing to complete successfully in server logs.

- HTTP response delivery timeout issue in Effect.js HttpBody extraction
- Endpoints /api/v1/tools/list and /api/v1/auth/status now work correctly
- Proper handling of nested Effect platform response structure

- Root cause: Incorrect extraction from Effect platform's nested HttpBody structure
- Solution: Extract body content from response.body.body instead of response.body
- Impact: All HTTP transport endpoints now deliver responses properly to clients

See CHANGELOG.md for complete details.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

v1.0.0

Release v1.0.0 - MCP Server for Unraid

First stable release of the MCP (Model Context Protocol) Server for Unraid, providing secure API access to Docker container management and system information.

- **MCP Protocol Support**: Full compliance with Model Context Protocol specification
- **Dual Transport**: Both STDIO and HTTP transport modes supported
- **Effect.ts Architecture**: Functional programming with Effect-ts for robust error handling
- **TypeScript**: Full type safety with strict mode enabled

- **Bearer Token Authentication**: Secure API token-based authentication
- **Timing-Safe Comparison**: Protection against timing attacks
- **Structured Audit Logging**: Comprehensive authentication attempt logging
- **Endpoint Protection**: Selective authentication requirements per endpoint

- **Container Management**: List, inspect, and manage Docker containers
- **System Overview**: Access to Unraid system information and metrics
- **Health Monitoring**: Built-in health check endpoints

- **Hot Reload**: Development server with automatic reloading
- **Comprehensive Testing**: Unit and integration test suites with coverage reporting
- **CI/CD Pipeline**: Automated testing, building, and Docker publishing

- **Semantic Versioning**: `1.0.0`, `1.0`, `1`, `latest` tags
- **Registry**: Available at `registry.haley.io/john/mcp-servers-unraid`
- **Architecture**: Multi-architecture support (AMD64/ARM64)

- **Security Hardening**: Non-root user, minimal attack surface
- **Health Checks**: Built-in container health monitoring
- **Environment Configuration**: Flexible configuration via environment variables
- **Production Ready**: Optimized for production deployment

- `API_TOKEN`: Required - Your Docker/Unraid API token
- `SERVER_TRANSPORT`: `stdio` (default) or `http`
- `HTTP_PORT`: HTTP server port (default: 8080)
- `HTTP_HOST`: HTTP server bind address (default: localhost)
- `LOG_LEVEL`: Logging level (default: info)

```bash
docker run -d \
  -e API_TOKEN=your_token_here \
  -e SERVER_TRANSPORT=http \
  -e HTTP_PORT=8080 \
  -p 8080:8080 \
  registry.haley.io/john/mcp-servers-unraid:1.0.0

curl http://localhost:8080/health
```

- **Functional Core**: Pure business logic with Effect.ts
- **Imperative Shell**: MCP protocol and external I/O handling
- **Boundary Enforcement**: ESLint rules prevent architectural violations

- **Coverage**: 20%+ test coverage requirement
- **Parallel Execution**: 4-way test sharding for faster CI
- **Integration Tests**: Full API integration testing
- **Security Scanning**: Container and dependency vulnerability scanning

- **Architecture-Specific Caching**: Separate caches for AMD64/ARM64
- **Parallel Test Execution**: 8-way parallel testing (4 unit + 4 integration)
- **Docker Layer Caching**: Registry-based BuildKit caching
- **Artifact Optimization**: Efficient artifact compression and transfer

- **Tagged Releases**: Automatic Docker publishing for semantic version tags
- **Security Scanning**: Trivy container vulnerability scanning
- **Quality Gates**: Comprehensive linting, type checking, and testing
- **Multi-Stage Builds**: Optimized container images

- **Minimal Base Image**: Alpine Linux for reduced attack surface
- **Security Scanning**: Automated vulnerability scanning with Trivy
- **Secrets Management**: Secure handling of API tokens and credentials
- **Network Security**: Configurable network access and port binding

- **Token Validation**: Robust API token validation and verification
- **Rate Limiting**: Protection against abuse and DoS attacks
- **Audit Trails**: Comprehensive logging of all API interactions
- **Input Validation**: Strict validation of all input parameters

- **Alpine Shell Compatibility**: Fixed bash regex syntax errors in Alpine containers
- **Tag Validation**: Standardized tag pattern matching across all CI jobs
- **Variable Scoping**: Resolved Docker tag variable scoping issues
- **Pattern Consistency**: Unified regex patterns for release tag detection
- **Workflow Rules**: Fixed CI pipeline execution for tagged releases
- **Regex Format**: Corrected regex pattern format for GitLab CI compatibility

- **Cache Architecture**: Architecture-specific dependency caching
- **Build Optimization**: Improved build times through better caching strategies
- **Test Parallelization**: Enhanced test execution performance
- **Pipeline Reliability**: More robust pipeline with better error handling
- **Configuration Cleanup**: Removed unnecessary variables and simplified workflow

- **Node Modules**: ~60% faster with architecture-specific caching
- **Docker Builds**: Registry-based layer caching for faster builds
- **Test Execution**: 4x faster with parallel test sharding
- **CI Pipeline**: Overall ~40% reduction in pipeline execution time

- **Memory Usage**: Optimized container memory footprint
- **Startup Time**: Fast server initialization with lazy loading
- **Response Times**: Sub-100ms response times for most endpoints
- **Resource Efficiency**: Minimal CPU and memory overhead

- **Extended Container Operations**: Start, stop, restart container management
- **Volume Management**: Docker volume inspection and management
- **Network Insights**: Container networking analysis and monitoring
- **Metrics Export**: Prometheus-compatible metrics endpoint

- **Enhanced Error Handling**: More detailed error messages and recovery
- **Configuration Validation**: Improved startup configuration validation
- **Documentation**: Expanded API documentation and usage examples
- **Performance Monitoring**: Built-in performance metrics and monitoring

---

**Docker Images**:
- `registry.haley.io/john/mcp-servers-unraid:1.0.0`
- `registry.haley.io/john/mcp-servers-unraid:1.0`
- `registry.haley.io/john/mcp-servers-unraid:1`
- `registry.haley.io/john/mcp-servers-unraid:latest`

**Requirements**: Docker API access, valid API token
**Compatibility**: Unraid 6.9+, Docker 20.10+
**License**: MIT

functional-core-start