v0.0.14

🌟 Release Highlights

This release focuses on improving reliability in containerized environments and enhancing the developer experience with better error handling and diagnostics.

✨ What's New

Pipe-Based Configuration Support (#115)

• MCP Gateway now supports launching via standard pipes and named FIFOs, ideal for containerized deployments
• Example: echo "$CONFIG_JSON" | awmg --config-stdin - perfect for Docker environments where file-based config isn't suitable
• Comprehensive integration tests ensure reliable stdin-based configuration

Version Logging at Startup (#116)

• Gateway version now logged on startup for easier operational troubleshooting
• Example: [INFO] [startup] MCPG Gateway version: v0.0.14
• Makes it simple to identify which version is running in production environments

Cleaner Error Messages (#117)

• Runtime errors now display without CLI help text clutter (4 lines instead of 27!)
• Error messages appear immediately and clearly - no more buried errors under usage text
• Flag parsing errors and --help still work normally

🐛 Bug Fixes & Improvements

Fixed Stdout Sync on Pipes (#114)

• Resolved sync /dev/stdout: invalid argument error in containerized environments
• Gateway now correctly detects pipes and character devices, avoiding unnecessary sync operations
• Added comprehensive test coverage for piped I/O scenarios

Enhanced JSON Schema Validation (#108)

• Improved schema validation with version information
• Disabled MCP input schema validation to prevent compatibility issues with MCP servers

Test Suite Improvements (#109, #103)

• Fixed Playwright integration test to use correct MCP image
• Cleaned up log message pollution in containerized runs
• More reliable test execution across environments

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.14
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

📚 Additional Resources

• Security Policy: Added SECURITY.md with disclosure guidelines (#100)
• SBOM Generation: Documentation for local SBOM generation using syft

---

For complete details, see the full changelog below.

---

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Fix log messages polluting command substitution in run_containerized.sh by @Copilot in #103
• Enhance JSON schema validation with version info and disable MCP input schema validation by @Copilot in #108
• Fix playwright integration test to use mcp/playwright image and verify tool registration by @Copilot in #109
• Fix stdout sync error on pipes and character devices by @Copilot in #114
• Suppress CLI help on runtime errors by @Copilot in #117
• Log gateway version at startup by @Copilot in #116
• Add pipe-based gateway launch integration test by @Copilot in #115

Full Changelog: v0.0.11...v0.0.14

v0.0.13

🌟 Release Highlights

This release enhances MCP Gateway's compatibility with diverse MCP servers and improves configuration validation feedback for developers.

✨ What's New

🔧 Multi-Version JSON Schema Support
MCP Gateway now gracefully handles backend MCP servers using different JSON Schema versions (draft-04, draft-07, etc.). Previously, servers like Playwright using draft-07 schemas could cause validation errors. The gateway now accepts tools from any compliant MCP server while maintaining strict validation for its own configuration files.

📋 Enhanced Configuration Error Messages
Configuration validation errors now include:

• Gateway version information for better issue reporting
• Hierarchical error display with clear context
• Specific suggestions for fixing each error type
• Direct links to the Configuration Specification and JSON Schema

This makes troubleshooting configuration issues significantly faster for developers.

🧪 Testing Improvements

• Added comprehensive integration tests for containerized Playwright MCP server
• Validates compatibility with real-world MCP servers using varied schema versions
• Improved test reliability with smarter Docker image handling

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.13
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

For complete details, see the full release notes.

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Enhance JSON schema validation with version info and disable MCP input schema validation by @Copilot in #108
• Fix playwright integration test to use mcp/playwright image and verify tool registration by @Copilot in #109

Full Changelog: v0.0.12...v0.0.13

v0.0.12

🌟 Release Highlights

This maintenance release fixes a critical bug in the containerized deployment scripts that prevented the gateway from starting properly.

🐛 Bug Fixes & Improvements

• Fixed command substitution capture issue (#103) - Resolved a problem where colored log messages were polluting command substitution in run_containerized.sh, causing the gateway to fail with unknown command errors. Log functions now properly write to stderr instead of stdout, ensuring clean separation between diagnostic output and program output.

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.12
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

For complete details, see the full release notes.

---

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Fix log messages polluting command substitution in run_containerized.sh by @Copilot in #103

Full Changelog: v0.0.11...v0.0.12

v0.0.11

🌟 Release Highlights

This release significantly improves MCP Gateway's reliability and compliance with enhanced validation, containerized execution support, and comprehensive testing infrastructure.

✨ What's New

Execution Environment Validation - MCP Gateway now validates its execution environment during startup, ensuring Docker daemon accessibility, required environment variables, and proper containerization setup. The new run_containerized.sh script provides specialized handling for containerized deployments with automatic validation of port mappings, stdin mode, and log directory mounts. PR #98

JSON Schema Validation - Configurations are now validated against the official MCP Gateway schema with regex constraints on all string fields. Invalid configurations fail fast with clear error messages and links to specification documentation. PR #94

Daily Compliance Checker - A new automated workflow continuously validates the implementation against the MCP Gateway specification, prioritizing recent changes and using cache memory to track validated aspects. Issues are created with detailed remediation suggestions and deep specification links. PR #93

⚡ Improvements

Split Test Suite - Tests are now organized into fast unit tests (no build required) and integration tests (binary required), enabling parallel CI execution and faster development feedback. New Makefile targets: test-unit, test-integration, and test-all. PR #82

Code Quality - Default values for command-line flags are now centralized as constants, improving maintainability and consistency throughout the codebase. PR #86

CI Alignment - Release workflow now uses standardized Makefile test targets (make test-unit, make test-integration) instead of raw go test commands, ensuring consistency across all workflows. PR #88

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.11
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

📚 Resources

• MCP Gateway Configuration Reference
• JSON Schema Specification
• Contributing Guide

---

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Constants for Default Values by @ppenna in #86
• Split test suite into unit and integration tests with separate CI jobs by @Copilot in #82
• Align release workflow with Makefile test targets by @Copilot in #88
• Validate JSON configuration against official MCP Gateway schema by @Copilot in #94
• Add daily compliance checker for MCP Gateway specification by @Copilot in #93
• Add execution environment validation for containerized MCP Gateway by @Copilot in #98

Full Changelog: v0.0.10...v0.0.11

v0.0.10

🌟 Release Highlights

This release brings comprehensive file-based logging to MCP Gateway, making it dramatically easier to debug MCP protocol interactions and diagnose issues in production environments.

✨ What's New

📝 Production-Ready File Logging (#84)

MCP Gateway now includes a robust file-based logging system that captures every critical event:

• Complete MCP Trace Logs: Every request and response logged with full details including tool names, session IDs, arguments, and results
• Session Lifecycle Tracking: Comprehensive logging of connection establishment, session initialization, and available servers
• Operational Events: Startup, shutdown, client interactions, backend server operations, and authentication events
• Smart Fallback: Logs written to mcp-gateway.log with automatic fallback to stdout if log directory unavailable

🔧 Configurable Log Directory

Control where logs are written with the new --log-dir flag:

# Use custom log directory
./awmg --config config.toml --log-dir /var/log/mcp-gateway

# Default location (if not specified)
# /tmp/gh-aw/sandbox/mcp/mcp-gateway.log

Logging Categories include: startup, shutdown, client, backend, auth - making it easy to filter and trace specific operations.

📚 Documentation

• Updated README.md with file logging usage
• Enhanced AGENTS.md with logging guidelines for contributors

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.10
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Add comprehensive file-based logging for gateway operations by @Copilot in #84

Full Changelog: v0.0.9...v0.0.10

v0.0.9

🌟 Release Highlights

This release focuses on improving the MCP Gateway's configuration validation, security features, and developer experience with enhanced testing and documentation.

✨ What's New

• Enhanced Configuration Validation: Spec-compliant configuration validation with fail-fast error handling and detailed error messages. The gateway now validates all required fields, port ranges, and environment variable expansion at startup, catching configuration issues early (#59, #76)
• Docker Mount & Entrypoint Support: Added support for entrypoint and mounts configuration fields, enabling more flexible container customization for MCP servers (#78)
• Shell Completion: Built-in shell completion support for bash, zsh, fish, and PowerShell with the new awmg completion command (#54)
• Binary Integration Tests: End-to-end CLI validation with binary integration tests to ensure the built binary works correctly before release (#53)

🐛 Bug Fixes & Improvements

• IPv6 Address Handling: Fixed IPv6 address parsing in gateway configuration output to properly handle bracketed addresses (#66)
• Cobra Deprecation Fix: Updated from deprecated cobra.ExactValidArgs to modern validation approach (#55)
• Release Workflow: Fixed CI workflow to run unit tests before building binary for integration tests, preventing test failures (#81, #79)

📚 Documentation

• Configuration Specification: Complete configuration reference with validation rules and best practices
• Release Process: Added comprehensive release instructions to CONTRIBUTING.md (#52)
• Environment Setup: Improved setup instructions for local development (#60)
• Agent Verification: New make agent-finished task for pre-completion verification workflow (#48)

🔧 Developer Experience

• Upgraded Dependencies: Cobra CLI framework updated to v1.10.2 for better performance and features
• Agentic Workflows: Added plan workflow for breaking down issues into sub-tasks (#44) and switched to issue-based feedback (#46)

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.9
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

For complete details, see the full changelog below.

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• [WIP] Fix failing GitHub Actions workflow release by @Copilot in #79
• Fix release workflow: run unit tests before building binary for integration tests by @Copilot in #81

Full Changelog: v0.0.8...v0.0.9

v0.0.4

🌟 Release Highlights

This release enhances MCP Gateway's build pipeline and testing infrastructure while improving documentation for GitHub Agentic Workflows integration.

✨ What's New

• Multi-platform binaries: MCP Gateway now builds for 12 platform/architecture combinations (darwin, linux, freebsd, windows across amd64/arm64/arm/386) with embedded version information and SHA256 checksums. Check your version with awmg --version. (#39)
• Automated test generation workflow: New test-coverage-improver workflow systematically improves test coverage by identifying complex, under-tested functions using Serena MCP for complexity analysis, then generating comprehensive table-driven tests. Runs daily to eliminate testing debt. (#41)

✅ Testing & Quality

• Tool name preservation tests: Added comprehensive validation ensuring the gateway exposes backend tool names without modification in routed mode. Tests cover various naming patterns (underscores, hyphens, camelCase, numbers, special characters) and verify correct behavior across both routed and unified modes. (#40)

📚 Documentation

• GitHub Agentic Workflows integration: README now highlights MCP Gateway's role as the MCP proxy layer for GitHub Agentic Workflows, specifically its use with the sandbox.mcp configuration to provide AI agents with MCP server access. (#37)

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.4
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

For complete details, see the full release notes.

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Add GitHub Agentic Workflows reference to README introduction by @Copilot in #37
• Add tests validating tool name preservation in routed mode by @Copilot in #40
• Add test-coverage-improver workflow for automated test generation by @Copilot in #41
• Import multi-platform build from gh-aw release workflow with version support by @Copilot in #39

Full Changelog: v0.0.3...v0.0.4

v0.0.3

🌟 Release Highlights

This release strengthens MCP Gateway's testing infrastructure and streamlines the release workflow, making it easier to validate gateway behavior and ship updates.

✨ What's New

🧪 MCP Test Harness for Integration Testing (#31)
MCP Gateway now includes a comprehensive test harness that makes it easy to validate gateway integration with backend MCP servers. The harness features:

• Configurable test servers: Create mock MCP servers with custom tools and resources
• Multiple transport support: Test both stdio and in-memory transports
• Validator client: Assert tool/resource availability and test invocations
• Gateway-ready integration tests: End-to-end testing for routed mode with multiple backends

This infrastructure enables robust testing of gateway routing, tool discovery, and resource handling—ensuring reliable MCP server integration.

🔧 Improvements

Simplified Release Workflow (#36)
Release content generation is now unified under the AI agent, eliminating redundant GitHub API calls and improving maintainability. Docker image information generates inline with release highlights.

Better make release Command (#34)
The release target now uses cleaner syntax: make release patch instead of make release BUMP=patch. The workflow URL has been updated to point to the correct release.lock.yml action.

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.3
# or
docker pull ghcr.io/githubnext/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64

---

For complete details, see the full release notes.

Ahoy! This treasure was crafted by 🏴‍☠️ Release

---

What's Changed

• Add MCP test harness for gateway integration testing by @Copilot in #31

Full Changelog: v0.0.2...v0.0.3

v0.0.1

What's Changed

• Refactor developer documentation into CONTRIBUTING.md by @Copilot in #29
• Reorganize documentation: move local development content to CONTRIBUTING.md by @Copilot in #33
• Add semver bump argument to make release by @Copilot in #32

Full Changelog: v0.0.0...v0.0.1