txn2/kubefwd

This release focuses on MCP (Model Context Protocol) stability improvements, MCPB bundle distribution for Claude Desktop, and enhanced test coverage.

Highlights

MCPB Bundle Support for Claude Desktop

kubefwd now ships with .mcpb bundles for one-click installation in Claude Desktop:

• macOS (Intel): kubefwd-1.25.1-darwin-amd64.mcpb
• macOS (Apple Silicon): kubefwd-1.25.1-darwin-arm64.mcpb
• Windows: kubefwd-1.25.1-windows-amd64.mcpb

Simply download and double-click to install kubefwd as an MCP server in Claude Desktop.

MCP Stability Improvements

• Fixed add_service race condition - The tool now waits for pod discovery to complete before returning, ensuring services appear in state immediately with correct connection info
• Improved tool descriptions - All 23 MCP tools now explicitly document required parameters, helping AI assistants use them correctly on the first try
• Enhanced namespace removal - Added proper cleanup of orphaned forwards and services when namespaces are removed

Event Bus Enhancements

• Added NamespaceRemoved event type for proper cleanup coordination
• Implemented unsubscribe logic for event handlers to prevent memory leaks
• Added blocking/unblocking logic to prevent race conditions during namespace removal

What's New

Features

• MCPB bundle generation and distribution via GitHub releases
• NamespaceRemoved event type and handler for TUI cleanup
• RemoveByNamespace method to clean up orphaned forwards and services
• MCP mode detection with banner suppression for cleaner output
• PodAdded event subscription for accurate service initialization

Bug Fixes

• Fixed race condition in add_service MCP tool that returned before pod discovery completed
• Fixed namespace removal leaving orphaned services in state store
• Fixed potential race conditions during namespace removal operations

Documentation

• Expanded MCP integration guide with detailed capability descriptions
• Added API documentation image to reference guide
• Updated README with new links for API Reference and MCP Integration
• Fixed typo: "API Refrence" → "API Reference"

Testing

• Added comprehensive MCP integration tests (398+ lines)
• Added test utilities and fixtures for MCP state management
• Added tests for RemoveByNamespace functionality
• Added tests for namespace blocking/unblocking behavior
• Added event bus unsubscribe tests
• Added TUI event handling tests

Dependencies

• Bumped golang.org/x/crypto from 0.44.0 to 0.45.0

Installation

Homebrew (macOS/Linux)

brew install txn2/tap/kubefwd

Claude Desktop (MCPB)

Download the appropriate .mcpb file for your platform and double-click to install.

Binary Download

Download the appropriate archive for your platform from the release assets.

Docker

docker pull txn2/kubefwd:v1.25.1

Package Managers

• APK: kubefwd_amd64.apk, kubefwd_arm64.apk
• DEB: kubefwd_amd64.deb, kubefwd_arm64.deb
• RPM: kubefwd_amd64.rpm, kubefwd_arm64.rpm

Checksums & Verification

All release artifacts include:

• SHA256 checksums in kubefwd_checksums.txt
• Sigstore signature in kubefwd_checksums.txt.sigstore.json
• SBOM (Software Bill of Materials) for each archive
• SLSA Level 3 provenance attestation

Verify signatures with:

cosign verify-blob \
  --bundle kubefwd_checksums.txt.sigstore.json \
  --certificate-identity-regexp="https://github.com/txn2/kubefwd" \
  --certificate-oidc-issuer="https://token.actions.githubusercontent.com" \
  kubefwd_checksums.txt

Breaking Changes

None.

Upgrade Notes

This is a drop-in replacement for v1.25.0. No configuration changes required.

Contributors

Thanks to all contributors who made this release possible.

Full Changelog

See the commit log for the complete list of changes.

Changelog

• 25143519b6ca5ee3f12088d23d122ca9c9a852ab Add API documentation image to reference guide
• 6bd48638fd2a9c2612e5a3123e16441ed95ee20a Add MCP mode detection and banner suppression logic
• 6d7d1d062f59da4a76dbb1fb576c05ed254e82ef Add NamespaceRemoved event type and its handler
• 833ee0b823d166794923002d91a417edb2164919 Add RemoveByNamespace to clean up orphaned forwards and services
• f52eeafecff91b3e63c43732ac83f0ed0e04a95e Add script and workflows to build and upload MCPB bundles
• 6af4115af8055baa57be5377cf35fcbee266e044 Add test utilities and integration tests for MCP state management
• 60781934c8326cacc7b0c7c74c963e27f1d7a038 Add tests for RemoveByNamespace in store
• 8a0b841f943fcd1f49423f3d4c67d3510e937b64 Add tests for namespace blocking and unblocking behavior in state store
• 684f61ab5aa34194133a4f9d504d09b535e5761b Add unsubscribe logic and tests for event handlers in Bus implementation
• 8b5b2159a132cef6e9fb61ff3e14289fbb39f7e0 Emit NamespaceRemoved event after service removal
• 77fc7dc055b211b73890d06524e3266be670050d Fix typo in README: correct "API Refrence" to "API Reference"
• b6439a0fab980a297c77d5cb9e4843b28a7af227 Handle NamespaceRemoved event in TUI
• e95fad36b750ef9263fc91f9f33fe3c419b901f7 Improve context handling and logging for namespace and service operations
• 0c07d778b2670062eca63ee47182dee11c0de942 Prevent race conditions during namespace removal by introducing blocking/unblocking logic in the state store
• 5111771717fb3b15ed8e68513d8b93bc9cb17d6d Revise and expand MCP integration guide with enhanced feature descriptions
• 971c30776e5d13377e758a7e89d72304aafde133 Specify required parameters in MCP tool descriptions
• 6695eb40287b747c8453ef639cf03d7e8661ee1e Subscribe to PodAdded events for services to ensure accurate initialization
• 4aca09fe809afd99ab96d76aca0ad9223da2847e Update README with new links for API Reference and MCP Integration
• da3255f90de04c94f5d14723bd7d1c77ddb96c35 deps: bump golang.org/x/crypto from 0.44.0 to 0.45.0