MCP Gateway Tools Dynamic Capabilities

Version: 1.0.0
Date: 2025-05-01

We're thrilled to announce MCP Gateway v1.0.0, a major update that transforms how your AI agents interact with MCP servers!

✨ New Feature: Dynamic Capability Registration

MCP Gateway now automatically discovers and exposes all capabilities from your proxied MCP servers as native gateway tools.

Key Capabilities:

• Transparent Proxying: All tools and resources from underlying MCP servers now appear as regular capabilities within the gateway itself with the format <MCP_NAME>_<TOOL_NAME>
• Improved Discoverability: LLMs can now see and use all available tools directly without needing to invoke generic proxy methods
• Consistent Interface: All proxied tools maintain their original signatures, parameters, and documentation
• Automatic Sanitization: All proxied capabilities still benefit from the gateway's security and sanitization features

Before vs After:

Previous approach (v0.x):

# Get metadata about available servers
servers_info = await mcp.get_metadata()
# Call a tool on a specific server through a generic proxy
result = await mcp.run_tool("filesystem", "list_directory", {"path": "."})

New approach (v1.0):

# Direct access to proxied tools with their original signatures
result = await mcp.filesystem_list_directory(path=".")

🔄 Simplified Plugin Configuration

Command-line arguments have been streamlined with a unified plugin system:

• New Syntax: Use -p plugin_name or --plugin plugin_name for all plugin types
• Backward Compatible: Still supports --enable-guardrails and --enable-tracing for existing configurations

Example:

# New syntax
mcp-gateway --mcp-json-path ~/.cursor/mcp.json -p basic -p xetrack

# Equivalent old syntax
mcp-gateway --mcp-json-path ~/.cursor/mcp.json --enable-guardrails basic --enable-tracing xetrack

🚀 Getting Started

1. Update to version 1.0.0:

   pip install mcp-gateway==1.0.0

2. Update your configuration:

   {
     "mcpServers": {
       "mcp-gateway": {
         "command": "mcp-gateway",
         "args": [
           "--mcp-json-path",
           "~/.cursor/mcp.json",
           "--plugin",
           "basic"
         ],
         "servers": {
           "filesystem": {
             "command": "npx",
             "args": [
               "-y",
               "@modelcontextprotocol/server-filesystem",
               "."
             ]
           }
         }
       }
     }
   }

3. Start using the dynamic capabilities: Any LLM or code interacting with your gateway will now see all proxied capabilities as native tools.

🔍 Metadata Tool Enhancements

The get_metadata tool remains available and has been enhanced to provide detailed information about all proxied servers and their original capabilities, making it easier to debug and introspect your MCP ecosystem.

What's Changed

• Feat: Dynamic capability registration in #3
• Feat: Unified plugin system with simplified arguments in #3
• Docs: Updated README with new command syntax and examples in #3