MCP Gateway & Registry v1.0.3

Release Date: October 8, 2025

We're excited to announce v1.0.3 of the MCP Gateway & Registry - the enterprise-ready platform that centralizes access to AI development tools using the Model Context Protocol (MCP).

What's New

Amazon Bedrock AgentCore Gateway Integration

Seamlessly integrate Amazon Bedrock AgentCore Gateways with the MCP Gateway Registry! This major enhancement brings enterprise-grade AI assistant capabilities to your MCP infrastructure.

Key Features:

Dual Authentication Flow - Keycloak ingress authentication for gateway access + Cognito egress authentication for AgentCore
Passthrough Token Mode - AgentCore tokens bypass gateway validation for direct authentication with AWS Cognito
Complete MCP Protocol Support - Full session initialization, tool discovery, and tool execution
Production-Ready Examples - Customer support assistant with warranty lookup and customer profile tools

Documentation: Amazon Bedrock AgentCore Integration Guide

Use Cases:

Deploy customer support assistants with knowledge base integration
Access AWS Lambda functions through managed MCP endpoints
Build AI agents with enterprise authentication and audit trails

Pre-built Docker Images - Deploy in Under 10 Minutes

Get running instantly with our pre-built Docker images! No compilation required - just download and run.

Benefits:

Instant deployment with ./build_and_run.sh --prebuilt
Faster updates and rollbacks
Support for both EC2 and macOS deployments
All components pre-compiled and optimized

Documentation:

Quick Start Guide
macOS Setup Guide
Pre-built Images Documentation

Keycloak Identity Provider Integration

Enterprise-grade authentication with complete audit trails and group-based authorization.

Features:

Individual AI agent identity management
Group-based access control with fine-grained permissions
Service account provisioning for automation
Production-ready OAuth 2.0 flows (M2M, 2LO, 3LO)
Complete audit trail for compliance (GDPR, SOX)

Documentation: Keycloak Integration Guide

Real-Time Metrics & Observability

Comprehensive monitoring and observability platform built on industry-standard tools.

Components:

Grafana Dashboards - Pre-built dashboards for server health, tool usage, and authentication
SQLite Storage - Efficient metrics storage with OTEL integration
Real-Time Monitoring - Track performance, errors, and usage patterns
Custom Metrics - Emit application-specific metrics from any component

Access: http://localhost:3000 (Grafana) | http://localhost:7860 (Registry UI)

Documentation: Observability Guide

Service & User Management Utilities

Comprehensive CLI tools for complete lifecycle management of MCP servers and users.

Capabilities:

Server registration and health validation
User provisioning with Keycloak integration
Group-based access control configuration
Automated testing and verification
Complete workflow examples

CLI Tools:

service_mgmt.sh - Server lifecycle management
User management utilities - Group and scope configuration
Health check automation

Documentation: Service Management Guide

Enhanced Features

Tag-Based Tool Filtering

Enhanced intelligent_tool_finder now supports hybrid search:

Semantic search for natural language queries
Tag-based filtering for categorical discovery
Combined search modes for precise tool selection

Three-Legged OAuth (3LO) Support

Integrate external services with user consent flows:

Atlassian (Jira, Confluence)
Google Workspace
GitHub
Custom OAuth providers

JWT Token Vending Service

Self-service token generation for automation:

Service account tokens
Time-limited access tokens
Automated credential rotation

Automated Token Refresh Service

Background token refresh maintains continuous authentication:

Automatic token renewal before expiration
Seamless credential management
Zero-downtime authentication

Improvements

Installation & Deployment

Eliminated sudo requirements - uses ${HOME} instead of /opt
Pre-built Docker images for instant deployment
Improved EC2 and macOS compatibility
Remote desktop setup guide for easier access

Authentication & Security

Dual authentication support (ingress + egress)
Passthrough token mode for external IdPs
Enhanced audit trails and compliance features
Fine-grained access control (FGAC) at server and tool levels

Developer Experience

Comprehensive documentation with examples
CLI tools for automation
Complete workflow examples
Modern React frontend with TypeScript

Observability

Real-time Grafana dashboards
OTEL-compatible metrics
Performance tracking
Usage analytics

Bug Fixes

Fixed URL formatting for bedrock-agentcore services
Improved token validation and refresh flows
Enhanced error messages and troubleshooting guides
Corrected documentation links and anchors

Documentation Updates

New: Amazon Bedrock AgentCore Integration Guide
Updated: Service Management Guide
Updated: Keycloak Integration Guide
Updated: Observability Guide
New: macOS Setup Guide
New: Remote Desktop Setup Guide

Quick Start

Option A: Pre-built Images (Recommended)

# Clone and setup
git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env

# Configure environment
export DOCKERHUB_ORG=mcpgateway

# Deploy with pre-built images
./build_and_run.sh --prebuilt

Option B: Build from Source

# Clone and setup
git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry

# Build and run
./build_and_run.sh

Next Steps:

Initialize Keycloak: Follow Initial Environment Configuration
Create your first AI agent: Create Your First AI Agent Account
Access the registry UI: http://localhost:7860
Monitor with Grafana: http://localhost:3000

Demo Videos

What's Included

MCP Gateway - Central gateway for all MCP traffic
Registry Service - Server and tool catalog with discovery
Auth Server - OAuth 2.0 authentication with Keycloak/Cognito
Frontend UI - Modern React interface for management
Metrics Service - OTEL-compatible observability
CLI Tools - Complete automation suite

System Requirements

Docker and Docker Compose
Python 3.11+ (for development)
4GB RAM minimum (8GB recommended)
EC2 instance or macOS system

Community & Support

Documentation: docs/
Issues: GitHub Issues
Discussions: GitHub Discussions
Contributing: CONTRIBUTING.md

Completed in This Release

#160 - Amazon Bedrock AgentCore Gateway integration documentation
#158 - Eliminate sudo requirements with ${HOME} directory usage
#111 - Standalone metrics collection service
#38 - Usage metrics and analytics system
#120 - CLI tool for MCP server registration and health validation
#119 - Well-known URL for MCP server discovery
#18 - Token vending capability
#5 - Keycloak IdP provider support

Roadmap

See our complete roadmap for upcoming features including:

Multi-level registry support (federated registries)
Virtual MCP server support with intelligent routing
Microsoft Entra ID (Azure AD) authentication
OpenSearch integration for advanced vector search
Agent-as-tool dynamic MCP server generation

License

This project is licensed under the Apache-2.0 License - see the LICENSE file for details.

Star this repository if it helps your organization!

Get Started | Documentation | Contribute

What's Changed

Feature agent m2m auth by @aarora79 in #2
UI Specific scopes by @dheerajoruganty in #4
Significant code refactor: docker compose, fgac by @aarora79 in #6
Add GitHub badges to README.md by @aarora79 in #19
Update 'What's New' Section with IdP Integration and FGAC by @aarora79 in #20
Create Root-Level .env.template File by @aarora79 in #21
Enhance docs/auth.md with Updated Architecture and Explanations by @aarora79 in #22
Update architecture diagram to include human users by @aarora79 in #23
Fix issue #14: Clean up Usage section and remove Cursor-specific references by @aarora79 in #24
Fix #12: Update Prerequisites and Installation Instructions in README.md by @aarora79 in #25
Fix issue #13: Restructure README and reorganize agent files by @aarora79 in #26
Fix issue #27: Update README API documentation by @aarora79 in #28
Create Comprehensive docs/cognito.md Guide by @aarora79 in #29
docs: Add comprehensive documentation for Dynamic Tool Discovery and Invocation by @aarora79 in #32
Standardize logging format across all Python files by @aarora79 in #34
Add comprehensive scopes.md documentation for fine-grained access control system by @aarora79 in #36
Fix #44: Add uv and Docker installation instructions to Quick Start by @aarora79 in #45
fix: self signed cert generation by @dheerajoruganty in #42
fix: server proxy pass urls for docker by @dheerajoruganty in #46
Fix documentation and nginx config updates by @aarora79 in #52
FGAC For MCPGW's Intelligent tool finder by @dheerajoruganty in #53
feat: Update FAISS index with all services on startup by @aarora79 in #55
Implement FastMCP 2.0 upgrade and httpx monkey patch by @aarora79 in #60
Fix scopes.yml path resolution and optimize FAISS loading in intelligent tool finder by @dheerajoruganty in #64
feat: Make environment file names configurable in agents/agent.py by @aarora79 in #67
feat: Refactor fininfo server with shared data fetching and add client-id support by @aarora79 in #69
JWT Token Vending Service + React Frontend Migration + GitHub Icon by @aarora79 in #79
JWT Token Vending Service + React Frontend Migration by @dheerajoruganty in #77
feat: Add JWT Token Vending Service and Modern React Frontend by @aarora79 in #88
Fix critical streamable-http transport routing and add comprehensive support by @aarora79 in #90
Enhanced MCP Gateway & Registry with SRE Gateway Integration by @aarora79 in #92
Implement GDPR/SOX compliance and MkDocs documentation website by @aarora79 in #99
Fix GitHub Actions workflow - update deprecated action versions by @aarora79 in #100
Fix broken LICENSE and legal document links by @aarora79 in #101
Update MkDocs logo to match README branding by @aarora79 in #102
Fix admin user visibility issue by @dheerajoruganty in #105
Fix health check ping fallback and implement healthy-auth-expired status by @aarora79 in #110
Add comprehensive testing documentation for shell scripts and Python agent by @aarora79 in #113
Complete Keycloak integration and documentation overhaul by @aarora79 in #117
Add Docker Hub publishing and pre-built container quickstart by @aarora79 in #123
Add architectural decision documentation for reverse proxy vs application-layer gateway by @aarora79 in #125
Add tag-based filtering to intelligent_tool_finder and streamline authentication by @aarora79 in #127
Documentation and README Updates - Feature List and Roadmap Synchronization by @aarora79 in #131
Add MacOS Setup Guide by @dheerajoruganty in #139
Docs: add prebuilt image catalog (Fixes #135) by @AdarshParakh in #141
119: Implement Well-Known URL for MCP Server Discovery (/.well-known/mcp-servers) by @nishadeborahphilips in #140
CLI Tool for MCP Server Registration and Health Validation (#120) by @aarora79 in #143
Update README: Add Star History chart and reorganize roadmap (#144) by @aarora79 in #145
Feature: Registry UI - Add MCP Configuration Generator with Copy-Paste Functionality by @nishadeborahphilips in #142
Feature/metrics collection service by @dheerajoruganty in #133
Update README: Reorganize What's New section with Observability subsection by @aarora79 in #149
Update volume path to use $HOME environment variable by @dheerajoruganty in #151
Fix .well-known/mcp-servers endpoint to display tool descriptions and route properly by @aarora79 in #153
Enable automatic external image mirroring and complete docker-compose.prebuilt.yml by @aarora79 in #156
Remove self-signed SSL certificate generation by @aarora79 in #163
update files to use new mount paths by @dheerajoruganty in #164
Feature/registry UI copy paste by @nishadeborahphilips in #161
Add comprehensive user and group management with Keycloak integration by @aarora79 in #166
Add comprehensive Amazon Bedrock AgentCore Gateway integration by @aarora79 in #169

New Contributors

@aarora79 made their first contribution in #2
@dheerajoruganty made their first contribution in #4
@AdarshParakh made their first contribution in #141
@nishadeborahphilips made their first contribution in #140

Full Changelog: https://github.com/agentic-community/mcp-gateway-registry/commits/v1.0.3

agentic-community/mcp-gateway-registry v1.0.3 First official release on GitHub