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