v0.1.0

🌟 Release Highlights

Welcome to v0.1.0, the first stable release of MCP Gateway! This milestone represents a production-ready Go-based proxy server for Model Context Protocol (MCP) servers, designed for use with GitHub Agentic Workflows.

✨ Core Features

🔀 Flexible Routing Modes

• Routed Mode: Access individual MCP servers at /mcp/{serverID} endpoints for dedicated connections
• Unified Mode: Single /mcp endpoint with intelligent routing across all configured servers

🐳 Docker-Native Backend Management

• Launch and manage MCP servers as containerized processes
• Automatic container lifecycle management with proper cleanup
• Environment variable injection for secure credential handling

🔧 Configuration Flexibility

• Support for both TOML files and JSON stdin configuration
• Spec-compliant validation with fail-fast error handling and detailed messages
• Environment variable expansion with ${VAR_NAME} syntax for secure credential management
• Full configuration specification available

🛡️ Robust Error Handling

• Enhanced debugging with detailed error context and troubleshooting suggestions
• Per-server log files ({serverID}.log) for easier isolation of issues
• Automatic schema normalization to fix malformed JSON schemas from backends
• Container detection with security warnings for nested containerization

🔌 Protocol Support

• JSON-RPC 2.0 over stdio transport for MCP communication
• Full Model Context Protocol implementation
• Transparent proxy with minimal latency overhead

🚀 Getting Started

Build and run the gateway locally:

# Clone and build
make build

# Configure your MCP servers (config.toml)
[gateway]
port = 3000
api_key = "your-api-key"

[servers.github]
command = "docker"
args = ["run", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "-i", "ghcr.io/github/github-mcp-server:latest"]

# Start the gateway
./awmg --config config.toml

🐳 Docker Image

The Docker image for this release is available at:

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

Supported platforms: linux/amd64, linux/arm64

📚 Documentation

• README - Quick start and overview
• CONTRIBUTING.md - Development setup and building from source
• Configuration Reference - Complete configuration specification

---

For complete details, see the full release notes.

Generated by Release

---

What's Changed

• Lpcox/update large xfer action by @lpcox in #860
• Hide enable-difc flag from public documentation by @Copilot in #864
• Sanitize sensitive data in all log outputs by @claude in #878
• [test-improver] Improve tests for main package by @github-actions[bot] in #871
• Fix workflow documentation to use dynamic workspace paths by @claude in #879
• Close #867: Test samples already exist in repository by @claude in #880
• Increase Test Coverage Improver timeout from 30 to 45 minutes by @claude in #881
• Clarify payload.json structure in large payload instructions by @claude in #883
• Implement Cobra v1.10.0 improvements: context support, declarative flag validation, and lifecycle hooks by @claude in #882

New Contributors

• @claude made their first contribution in #878

Full Changelog: v0.0.113...v0.1.0