0.3.0 version bump (#326)

* 0.3.0 version bump

Signed-off-by: Mihai Criveti <[email protected]>

* Added 0.3.0 CHANGELOG

Signed-off-by: Mihai Criveti <[email protected]>

* Added 0.3.0 README updates

Signed-off-by: Mihai Criveti <[email protected]>

* Updated roadmap

Signed-off-by: Mihai Criveti <[email protected]>

---------

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

.bumpversion.cfg

@@ -1,12 +1,12 @@
 [bumpversion]
-current_version = 0.2.0
+current_version = 0.3.0
 commit = False
 tag = False
 sign-tags = True
 tag_name = v{new_version} # tag format (only used if you flip tag=True later)
 parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)
-serialize =
-    {major}.{minor}.{patch}
+serialize = 
+	{major}.{minor}.{patch}
 
 [bumpversion:file:mcpgateway/__init__.py]
 search = __version__ = "{current_version}"

.github/tools/cleanup-ghcr-versions.sh

@@ -92,7 +92,7 @@ fi
 ##############################################################################
 ORG="ibm"
 PKG="mcp-context-forge"
-KEEP_TAGS=( "0.1.0" "v0.1.0" "0.1.1" "v0.1.1" "0.2.0" "v0.2.0" "latest" )
+KEEP_TAGS=( "0.1.0" "v0.1.0" "0.1.1" "v0.1.1" "0.2.0" "v0.2.0" "0.3.0" "v0.3.0" "latest" )
 PER_PAGE=100
 
 DRY_RUN=${DRY_RUN:-true}          # default safe

.github/tools/generate-changelog-info.sh

@@ -15,7 +15,7 @@
 #
 set -euo pipefail
 
-TAG=${1:-v0.1.1}
+TAG=${1:-v0.2.0}
 OUT=${2:-changelog_info.txt}
 
 ###############################################################################

.github/workflows/docker-release.yml

@@ -4,12 +4,12 @@
 #
 # This workflow re-tags a Docker image (built by a previous workflow)
 # when a GitHub Release is published, giving it a semantic version tag
-# like `v0.2.0`. It assumes the CI build has already pushed an image
+# like `v0.3.0`. It assumes the CI build has already pushed an image
 # tagged with the commit SHA, and that all checks on that commit passed.
 #
 # ➤ Trigger: Release published (e.g. from GitHub UI or `gh release` CLI)
 # ➤ Assumes: Existing image tagged with the commit SHA is available
-# ➤ Result: Image re-tagged as `ghcr.io/OWNER/REPO:v0.2.0`
+# ➤ Result: Image re-tagged as `ghcr.io/OWNER/REPO:v0.3.0`
 #
 # ======================================================================
 
@@ -25,7 +25,7 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: 'Release tag (e.g., v0.2.0)'
+        description: 'Release tag (e.g., v0.3.0)'
         required: true
         type: string
 

.github/workflows/release-chart.yml.inactive

@@ -2,7 +2,7 @@
 name: Release Helm Chart
 on:
   release:
-    types: [published]            # tag repo, ex: v0.2.0 to trigger
+    types: [published]            # tag repo, ex: v0.3.0 to trigger
 permissions:
   contents: read
   packages: write

CHANGELOG.md

@@ -6,15 +6,140 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ---
 
-## [0.3.0] - 2025-07-08 (pending)
+## [0.3.0] - 2025-07-08
 
+### Added
+
+* **Transport-Translation Bridge (`mcpgateway.translate`)** - bridges local JSON-RPC/stdio servers to HTTP/SSE and vice versa:
+  * Expose local stdio MCP servers over SSE endpoints with session management
+  * Bridge remote SSE endpoints to local stdio for seamless integration
+  * Built-in keepalive mechanisms and unique session identifiers
+  * Full CLI support: `python -m mcpgateway.translate --stdio "uvx mcp-server-git" --port 9000`
+
+* **Tool Annotations & Metadata** - comprehensive tool annotation system:
+  * New `annotations` JSON column in tools table for storing rich metadata
+  * UI support for viewing and managing tool annotations
+  * Alembic migration scripts for smooth database upgrades (`e4fc04d1a442`)
+
+* **Multi-server Tool Federations** - resolved tool name conflicts across gateways (#116):
+  * **Composite Key & UUIDs for Tool Identity** - tools now uniquely identified by `(gateway_id, name)` instead of global name uniqueness
+  * Generated `qualified_name` field (`gateway.tool`) for human-readable tool references
+  * UUID primary keys for Gateways, Tools, and Servers for future-proof references
+  * Enables adding multiple gateways with same-named tools (e.g., multiple `google` tools)
+
+* **Auto-healing & Visibility** - enhanced gateway and tool status management (#159):
+  * **Separated `is_active` into `enabled` and `reachable` fields** for better status granularity (#303)
+  * Auto-activation of MCP servers when they come back online after being marked unreachable
+  * Improved status visibility in Admin UI with proper enabled/reachable indicators
+
+* **Export Connection Strings** - one-click client integration (#154):
+  * Generate ready-made configs for LangChain, Claude Desktop, and other MCP clients
+  * `/servers/{id}/connect` API endpoint for programmatic access
+  * Download connection strings directly from Admin UI
+
+* **Configurable Connection Retries** - resilient startup behavior (#179):
+  * `DB_MAX_RETRIES` and `DB_RETRY_INTERVAL_MS` for database connections
+  * `REDIS_MAX_RETRIES` and `REDIS_RETRY_INTERVAL_MS` for Redis connections
+  * Prevents gateway crashes during slow service startup in containerized environments
+  * Sensible defaults (3 retries × 2000ms) with full configurability
+
+* **Dynamic UI Picker** - enhanced tool/resource/prompt association (#135):
+  * Searchable multi-select dropdowns replace raw CSV input fields
+  * Preview tool metadata (description, request type, integration type) in picker
+  * Maintains API compatibility with CSV backend format
+
+* **Developer Experience Improvements**:
+  * **Developer Workstation Setup Guide** for Mac (Intel/ARM), Linux, and Windows (#18)
+  * Comprehensive environment setup instructions including Docker/Podman, WSL2, and common gotchas
+  * Signing commits guide with proper gitconfig examples
+
+* **Infrastructure & DevOps**:
+  * **Enhanced Helm charts** with health probes, HPA support, and migration jobs
+  * **Fast Go MCP server example** (`mcp-fast-time-server`) for high-performance demos (#265)
+  * Database migration management with proper Alembic integration
+  * Init containers for database readiness checks
+
+### Changed
+
+* **Database Schema Evolution**:
+  * `tools.name` no longer globally unique - now uses composite key `(gateway_id, name)`
+  * Migration from single `is_active` field to separate `enabled` and `reachable` boolean fields
+  * Added UUID primary keys for better federation support and URL-safe references
+  * Moved Alembic configuration inside `mcpgateway` package for proper wheel packaging
+
+* **Enhanced Federation Manager**:
+  * Updated to use new `enabled` and `reachable` fields instead of deprecated `is_active`
+  * Improved gateway synchronization and health check logic
+  * Better error handling for offline tools and gateways
+
+* **Improved Code Quality**:
+  * **Fixed Pydantic v2 compatibility** - replaced deprecated patterns:
+    * `Field(..., env=...)` → `model_config` with BaseSettings
+    * `class Config` → `model_config = ConfigDict(...)`
+    * `@validator` → `@field_validator`
+    * `.dict()` → `.model_dump()`, `.parse_obj()` → `.model_validate()`
+  * **Replaced deprecated stdlib functions** - `datetime.utcnow()` → `datetime.now(timezone.utc)`
+  * **Pylint improvements** across codebase with better configuration and reduced warnings
+
+* **File System & Deployment**:
+  * **Fixed file lock path** - now correctly uses `/tmp/gateway_service_leader.lock` instead of current directory (#316)
+  * Improved Docker and Helm deployment with proper health checks and resource limits
+  * Better CI/CD integration with updated linting and testing workflows
+
+### Fixed
+
+* **UI/UX Fixes**:
+  * **Close button for parameter input** in Global Tools tab now works correctly (#189)
+  * **Gateway modal status display** - fixed `isActive` → `enabled && reachable` logic (#303)
+  * Dark mode improvements and consistent theme application (#26)
+
+* **API & Backend Fixes**:
+  * **Gateway reactivation warnings** - fixed 'dict' object Pydantic model errors (#28)
+  * **GitHub Remote Server addition** - resolved server registration flow issues (#152)
+  * **REST path parameter substitution** - improved payload handling for REST APIs (#100)
+  * **Missing await on coroutine** - fixed async response handling in tool service
+
+* **Build & Packaging**:
+  * **Alembic configuration packaging** - migration scripts now properly included in pip wheels (#302)
+  * **SBOM generation failure** - fixed documentation build issues (#132)
+  * **Makefile image target** - resolved Docker build and documentation generation (#131)
+
+* **Testing & Quality**:
+  * **Improved test coverage** - especially in `test_tool_service.py` reaching 90%+ coverage
+  * **Redis connection handling** - better error handling and lazy imports
+  * **Fixed flaky tests** and improved stability across test suite
+  * **Pydantic v2 compatibility warnings** - resolved deprecated patterns and stdlib functions (#197)
+
+### Security
+
+* **Enhanced connection validation** with configurable retry mechanisms
+* **Improved credential handling** in Basic Auth and JWT implementations
+* **Better error handling** to prevent information leakage in federation scenarios
+
+---
+
+### 🙌 New contributors in 0.3.0
+
+Thanks to the **first-time contributors** who delivered features in 0.3.0:
 
-## [0.2.1] - 2025-07-01 (pending)
+| Contributor              | Contributions                                                               |
+| ------------------------ | --------------------------------------------------------------------------- |
+| **Irusha Basukala**      | Comprehensive Developer Workstation Setup Guide for Mac, Linux, and Windows |
+| **Michael Moyles**       | Fixed close button functionality for parameter input scheme in UI           |
+| **Reeve Barreto**        | Configurable connection retries for DB and Redis with extensive testing     |
+| **Chris PC-39**          | Major pylint improvements and code quality enhancements                     |
+| **Ruslan Magana**        | Watsonx.ai Agent documentation and integration guides                       |
+| **Shaikh Quader**        | macOS-specific setup documentation                                          |
+| **Mohan Lakshmaiah**     | Test case updates and coverage improvements                                 |
 
-* Allow tool federation across gateways by **allowing tools of same names** from different MCP servers to be added.
-* **Fix tool list refresh** from Deactivate/Activate cycles and Edit Gateway screen.
-* **Improve tool selection experience for servers** by allowing selection based on name from a dropdown.
+### 🙏 Returning contributors who delivered in 0.3.0
 
+| Contributor          | Key contributions                                                                                                                                                                                                                   |
+| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Mihai Criveti**    | **Release coordination**, code reviews, mcpgateway.translate stdio ↔ SSE, overall architecture, Issue Creation, Helm chart enhancements, HPA support, pylint configuration, documentation updates, isort cleanup, and infrastructure improvements                                                                         |
+| **Manav Gupta**      | **Transport-Translation Bridge** mcpgateway.translate Reverse SSE ↔ stdio bridging,                                                                                                                |
+| **Madhav Kandukuri** | **Composite Key & UUIDs migration**, Alembic integration, extensive test coverage improvements, database schema evolution, and tool service enhancements                                                                            |
+| **Keval Mahajan**    | **Auto-healing capabilities**, enabled/reachable status migration, federation UI improvements, file lock path fixes, and wrapper functionality                                                                                      |
 
 ## [0.2.0] - 2025-06-24
 

Containerfile

@@ -1,7 +1,7 @@
 FROM registry.access.redhat.com/ubi9-minimal:9.6-1750782676
 LABEL maintainer="Mihai Criveti" \
       name="mcp/mcpgateway" \
-      version="0.2.0" \
+      version="0.3.0" \
       description="MCP Gateway: An enterprise-ready Model Context Protocol Gateway"
 
 ARG PYTHON_VERSION=3.11

Containerfile.lite

@@ -106,7 +106,7 @@ LABEL maintainer="Mihai Criveti" \
       org.opencontainers.image.title="mcp/mcpgateway" \
       org.opencontainers.image.description="MCP Gateway: An enterprise-ready Model Context Protocol Gateway" \
       org.opencontainers.image.licenses="Apache-2.0" \
-      org.opencontainers.image.version="0.2.0"
+      org.opencontainers.image.version="0.3.0"
 
 # ----------------------------------------------------------------------------
 # Copy the entire prepared root filesystem from the builder stage

Makefile

@@ -1420,7 +1420,7 @@ MINIKUBE_ADDONS  ?= ingress ingress-dns metrics-server dashboard registry regist
 # OCI image tag to preload into the cluster.
 # - By default we point to the *local* image built via `make docker-prod`, e.g.
 #   mcpgateway/mcpgateway:latest.  Override with IMAGE=<repo:tag> to use a
-#   remote registry (e.g. ghcr.io/ibm/mcp-context-forge:v0.2.0).
+#   remote registry (e.g. ghcr.io/ibm/mcp-context-forge:v0.3.0).
 TAG              ?= latest         # override with TAG=<ver>
 IMAGE            ?= $(IMG):$(TAG)  # or IMAGE=ghcr.io/ibm/mcp-context-forge:$(TAG)
 

README.md

@@ -336,13 +336,13 @@ docker run -d --name mcpgateway \
   -e BASIC_AUTH_PASSWORD=changeme \
   -e AUTH_REQUIRED=true \
   -e DATABASE_URL=sqlite:///./mcp.db \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 
 # Tail logs (Ctrl+C to quit)
 docker logs -f mcpgateway
 
 # Generating an API key
-docker run --rm -it ghcr.io/ibm/mcp-context-forge:0.2.0 \
+docker run --rm -it ghcr.io/ibm/mcp-context-forge:0.3.0 \
   python -m mcpgateway.utils.create_jwt_token --username admin --exp 0 --secret my-test-key
 ```
 
@@ -362,7 +362,7 @@ docker run -d --name mcpgateway \
   -e JWT_SECRET_KEY=my-test-key \
   -e BASIC_AUTH_USER=admin \
   -e BASIC_AUTH_PASSWORD=changeme \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 ```
 
 SQLite now lives on the host at `./data/mcp.db`.
@@ -376,7 +376,7 @@ docker run -d --name mcpgateway \
   -e PORT=4444 \
   -e DATABASE_URL=sqlite:////data/mcp.db \
   -v $(pwd)/data:/data \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 ```
 
 Using `--network=host` allows Docker to access the local network, allowing you to add MCP servers running on your host. See [Docker Host network driver documentation](https://docs.docker.com/engine/network/drivers/host/) for more details.
@@ -392,7 +392,7 @@ podman run -d --name mcpgateway \
   -p 4444:4444 \
   -e HOST=0.0.0.0 \
   -e DATABASE_URL=sqlite:///./mcp.db \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 ```
 
 #### 2 - Persist SQLite
@@ -405,7 +405,7 @@ podman run -d --name mcpgateway \
   -p 4444:4444 \
   -v $(pwd)/data:/data \
   -e DATABASE_URL=sqlite:////data/mcp.db \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 ```
 
 #### 3 - Host networking (rootless)
@@ -415,7 +415,7 @@ podman run -d --name mcpgateway \
   --network=host \
   -v $(pwd)/data:/data \
   -e DATABASE_URL=sqlite:////data/mcp.db \
-  ghcr.io/ibm/mcp-context-forge:0.2.0
+  ghcr.io/ibm/mcp-context-forge:0.3.0
 ```
 
 ---
@@ -424,7 +424,7 @@ podman run -d --name mcpgateway \
 <summary><strong>✏️ Docker/Podman tips</strong></summary>
 
 * **.env files** - Put all the `-e FOO=` lines into a file and replace them with `--env-file .env`. See the provided [.env.example](.env.example) for reference.
-* **Pinned tags** - Use an explicit version (e.g. `v0.2.0`) instead of `latest` for reproducible builds.
+* **Pinned tags** - Use an explicit version (e.g. `v0.3.0`) instead of `latest` for reproducible builds.
 * **JWT tokens** - Generate one in the running container:
 
   ```bash
@@ -470,7 +470,7 @@ docker run --rm -i \
   -e MCP_SERVER_CATALOG_URLS=http://host.docker.internal:4444/servers/UUID_OF_SERVER_1 \
   -e MCP_TOOL_CALL_TIMEOUT=120 \
   -e MCP_WRAPPER_LOG_LEVEL=DEBUG \
-  ghcr.io/ibm/mcp-context-forge:0.2.0 \
+  ghcr.io/ibm/mcp-context-forge:0.3.0 \
   python3 -m mcpgateway.wrapper
 ```
 
@@ -518,7 +518,7 @@ python3 -m mcpgateway.wrapper
 <summary><strong>Expected responses from mcpgateway.wrapper</strong></summary>
 
 ```json
-{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"experimental":{},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"tools":{"listChanged":false}},"serverInfo":{"name":"mcpgateway-wrapper","version":"0.2.0"}}}
+{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"experimental":{},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"tools":{"listChanged":false}},"serverInfo":{"name":"mcpgateway-wrapper","version":"0.3.0"}}}
 
 # When there's no tools
 {"jsonrpc":"2.0","id":2,"result":{"tools":[]}}
@@ -550,7 +550,7 @@ docker run -i --rm \
   -e MCP_SERVER_CATALOG_URLS=http://localhost:4444/servers/UUID_OF_SERVER_1 \
   -e MCP_AUTH_TOKEN=${MCPGATEWAY_BEARER_TOKEN} \
   -e MCP_TOOL_CALL_TIMEOUT=120 \
-  ghcr.io/ibm/mcp-context-forge:0.2.0 \
+  ghcr.io/ibm/mcp-context-forge:0.3.0 \
   python3 -m mcpgateway.wrapper
 ```