Skip to content

Releases: github/gh-aw-mcpg

v0.0.98

04 Feb 00:16
3f95af0

Choose a tag to compare

🌟 Release Highlights

This release focuses on improving Docker container management and debugging capabilities, making it easier to diagnose and troubleshoot MCP backend server issues.

✨ What's New

  • Real-time Container Logs (#621): MCP Gateway now streams container stderr output in real-time during operation, not just on failures. This provides immediate visibility into backend server behavior and makes debugging significantly easier.

  • Improved Docker API Compatibility (#620): The gateway now uses the Docker server's current API version instead of requiring a minimum version. This resolves compatibility issues with different Docker daemon configurations and reduces connection errors.

🔧 Performance & Reliability

  • MCP Stress Testing (#616): Added comprehensive stress testing to validate gateway stability under heavy load conditions, ensuring reliable operation in production environments.

  • Gateway Updates (#617, #618): Internal improvements and dependency updates to the gateway core for better stability and maintainability.

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/github/gh-aw-mcpg:v0.0.98
# or
docker pull ghcr.io/github/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

  • Lpcox/mcp stress test by @lpcox in #616
  • Updated to gateway v0.0.96 by @lpcox in #617
  • updated gateway by @lpcox in #618
  • fix: use Docker server's current API version instead of minimum by @lpcox in #620
  • feat: stream container stderr in real-time instead of only on failure by @lpcox in #621

Full Changelog: v0.0.96...v0.0.98

v0.0.97

04 Feb 00:12
3f95af0

Choose a tag to compare

What's Changed

  • Lpcox/mcp stress test by @lpcox in #616
  • Updated to gateway v0.0.96 by @lpcox in #617
  • updated gateway by @lpcox in #618
  • fix: use Docker server's current API version instead of minimum by @lpcox in #620
  • feat: stream container stderr in real-time instead of only on failure by @lpcox in #621

Full Changelog: v0.0.96...v0.0.97

v0.0.96

03 Feb 22:24
16b80f1

Choose a tag to compare

🌟 Release Highlights

This maintenance release improves observability and debugging capabilities for MCP Gateway operations.

✨ What's New

  • Enhanced Logging Visibility: MCP Gateway now displays the active logging level on startup, making it easier to verify debug configuration (#611)
  • Better Container Diagnostics: When MCP server connections fail, the gateway now automatically captures and logs container stderr output, providing immediate insight into backend server issues (#615)

🐛 Bug Fixes & Improvements

  • Resolved build errors and lint warnings to maintain code quality (#612)
  • Added debug logging to schema normalization processes for better troubleshooting (#606)
  • Improved test coverage for logger package (#609)

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/github/gh-aw-mcpg:v0.0.96
# or
docker pull ghcr.io/github/gh-aw-mcpg:latest

Supported platforms: linux/amd64, linux/arm64


For complete details, see the full changelog.

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


What's Changed

  • Lpcox/migrate to GitHub by @lpcox in #597
  • chore: update gh-aw-mcpg container to v0.0.94 by @lpcox in #600
  • feat: print logging level on startup and centralize DEBUG constant by @lpcox in #611
  • [log] Add debug logging to MCP types schema normalization by @github-actions[bot] in #606
  • [test-improver] Improve tests for logger package (slog_adapter) by @github-actions[bot] in #609
  • fix: resolve build errors and lint warnings by @lpcox in #612
  • Lpcox/print failed container logs by @lpcox in #613
  • Revert "Lpcox/print failed container logs" by @lpcox in #614
  • feat: capture and log container stderr when MCP connection fails by @lpcox in #615

Full Changelog: v0.0.94...v0.0.96

v0.0.95

03 Feb 22:14
16b80f1

Choose a tag to compare

What's Changed

  • Lpcox/migrate to GitHub by @lpcox in #597
  • chore: update gh-aw-mcpg container to v0.0.94 by @lpcox in #600
  • feat: print logging level on startup and centralize DEBUG constant by @lpcox in #611
  • [log] Add debug logging to MCP types schema normalization by @github-actions[bot] in #606
  • [test-improver] Improve tests for logger package (slog_adapter) by @github-actions[bot] in #609
  • fix: resolve build errors and lint warnings by @lpcox in #612
  • Lpcox/print failed container logs by @lpcox in #613
  • Revert "Lpcox/print failed container logs" by @lpcox in #614
  • feat: capture and log container stderr when MCP connection fails by @lpcox in #615

Full Changelog: v0.0.94...v0.0.95

v0.0.94

03 Feb 00:02
2491b68

Choose a tag to compare

🌟 Release Highlights

This release focuses on enhanced observability, testing infrastructure, and reliability for MCP Gateway. Key improvements include upgraded SDK observability, comprehensive test coverage for critical components, and refined logging capabilities.

✨ What's New

  • 🔍 Enhanced SDK Observability (#590) - Upgraded to go-sdk v1.2.0, bringing improved resource management, built-in request/response logging, and better error tracking for MCP server interactions. This provides deeper visibility into backend server behavior and simplifies debugging.

  • 🔐 Authentication Debug Logging (#587) - Added detailed debug logging to the authentication middleware, making it easier to troubleshoot authorization issues and track session management. Enable with DEBUG=auth:* for real-time auth flow visibility.

  • 💾 Large Payload Storage (#593) - Comprehensive tests now validate the large payload storage system and session isolation. The gateway stores oversized tool responses in /tmp/jq-payloads (configurable via --payload-dir), ensuring agents can access full payloads when responses exceed size limits.

🐛 Bug Fixes & Improvements

  • ✅ Test Infrastructure - Multiple improvements to test reliability:
    • Added comprehensive timeout tests for launcher operations (#578)
    • Enhanced logger package test coverage (#589)
    • Fixed linting errors and test logic in JSONL logger (#591)
    • Updated test expectations to match actual error messages (#592)

🐳 Docker Image

The Docker image for this release is available at:

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

Supported platforms: linux/amd64, linux/arm64

📖 Getting Started

For configuration guidance, see:


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


What's Changed

  • [test] Add comprehensive timeout tests for launcher.GetOrLaunch() by @github-actions[bot] in #578
  • [log] Add debug logging to authentication middleware by @github-actions[bot] in #587
  • [test-improver] Improve tests for logger package by @github-actions[bot] in #589
  • fix: resolve linting errors and fix test logic in jsonl_logger_test.go by @lpcox in #591
  • Upgrade go-sdk to v1.2.0 with enhanced observability and resource management by @Copilot in #590
  • fix: update test expectations to match actual error messages by @lpcox in #592
  • test: add tests for large payload storage and session isolation by @lpcox in #593

Full Changelog: v0.0.92...v0.0.94

v0.0.93

02 Feb 23:47
2491b68

Choose a tag to compare

What's Changed

  • [test] Add comprehensive timeout tests for launcher.GetOrLaunch() by @github-actions[bot] in #578
  • [log] Add debug logging to authentication middleware by @github-actions[bot] in #587
  • [test-improver] Improve tests for logger package by @github-actions[bot] in #589
  • fix: resolve linting errors and fix test logic in jsonl_logger_test.go by @lpcox in #591
  • Upgrade go-sdk to v1.2.0 with enhanced observability and resource management by @Copilot in #590
  • fix: update test expectations to match actual error messages by @lpcox in #592
  • test: add tests for large payload storage and session isolation by @lpcox in #593

Full Changelog: v0.0.92...v0.0.93

v0.0.92

02 Feb 05:03
72ddf9f

Choose a tag to compare

🌟 Release Highlights

This release focuses on developer experience improvements with a significant internal refactoring that makes the codebase easier to maintain and extend.

🔧 Developer Experience

Modular Flag and Config Registration (#575)

We've restructured the CLI flag and configuration registration system to dramatically reduce merge conflicts during parallel development:

  • Decentralized flag registration: Each flag now lives in its own file with self-contained initialization
  • Plugin-style architecture: Add new flags without touching shared files by creating flags_myfeature.go
  • Cleaner codebase: Reduced coupling between CLI components across 15 files
  • Conflict-free collaboration: Multiple developers can now add flags simultaneously without merge headaches

Developer Impact: This architectural improvement makes MCP Gateway easier to extend and maintain, especially important as we continue rapid development. Contributors can now add new CLI flags, configuration options, or features with minimal risk of conflicts.

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.92
# 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

  • refactor: modular flag and config registration to reduce merge conflicts by @lpcox in #575

Full Changelog: v0.0.90...v0.0.92

v0.0.91

02 Feb 04:57
72ddf9f

Choose a tag to compare

What's Changed

  • refactor: modular flag and config registration to reduce merge conflicts by @lpcox in #575

Full Changelog: v0.0.90...v0.0.91

v0.0.90

02 Feb 01:21
a0c81de

Choose a tag to compare

🌟 Release Highlights

This release focuses on improving documentation accuracy and enhancing payload handling for AI agents working with large tool responses.

✨ What's New

Session-Segmented Payload Directory (#569)

  • Added configurable payload directory with session-based organization
  • Enables agents to mount their session-specific subdirectory ({payload_dir}/{sessionID}/) for direct access to full tool response payloads
  • Payloads stored as: {payload_dir}/{sessionID}/{queryID}/payload.json
  • Configurable via --payload-dir flag, MCP_GATEWAY_PAYLOAD_DIR env var, or payload_dir in config
  • Default location: /tmp/jq-payloads
  • The jq middleware now returns: preview (first 500 chars), schema, payloadPath, queryID, originalSize, and truncated flag

This enhancement improves handling of large MCP tool responses by storing full payloads on disk while returning concise summaries to agents. Agents can then access the complete data when needed by mounting their session-specific directory.

📚 Documentation

Documentation Accuracy Improvements (#568)

  • Fixed documentation to accurately reflect the current implementation
  • Ensured consistency between docs and actual gateway behavior

🐳 Docker Image

The Docker image for this release is available at:

docker pull ghcr.io/githubnext/gh-aw-mcpg:v0.0.90
# 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 documentation to match implementation by @Copilot in #568
  • Add configurable session-segmented payload directory for agent access by @Copilot in #569

Full Changelog: v0.0.88...v0.0.90

v0.0.89

02 Feb 01:17
a0c81de

Choose a tag to compare

What's Changed

  • Fix documentation to match implementation by @Copilot in #568
  • Add configurable session-segmented payload directory for agent access by @Copilot in #569

Full Changelog: v0.0.88...v0.0.89