Skip to main content
Glama
dmartinol

mcp-gateway-mcp

by dmartinol
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

mcp-gateway-mcp

Admin MCP server for the mcp-gateway platform. Exposes Kubernetes CRD state and live broker status as MCP tools and browser-renderable UI widgets — no kubectl required.

Target audience: platform engineers operating a running gateway.

UI Widgets

Four interactive MCP App widgets render as sandboxed iframes in MCP Apps-compatible hosts (Claude, Cursor, VS Code Copilot, ChatGPT, …). See sample-prompts.md for the phrases that open each one.

Browse all federated tools grouped by server. Click any row to expand the full description and input schema parameters.

Tool Catalog

Live broker status, reachability summary, and per-server tool counts at a glance.

Gateway Health Dashboard

Table of all MCPServerRegistration CRs with toggle switches to enable or disable each server without kubectl.

Registration Manager

Accordion view of MCPVirtualServer CRs showing upstreams, status conditions, and spec fields.

Virtual Server Viewer

Related MCP server: MCP Manager

Tools

Tool

Access

Description

list_registrations

📖 read

List all MCPServerRegistration CRs

get_registration

📖 read

Get a single registration with status conditions

update_registration_state

✏️ write

Enable or disable a registration

list_virtual_servers

📖 read

List all MCPVirtualServer CRs

get_virtual_server

📖 read

Get a single virtual server

get_gateway_status

📖 read

Call the broker /status endpoint

render_tool_catalog

📖 read

Open the interactive tool catalog widget

render_registrations

✏️ write

Open the registration manager widget (toggle switches mutate state)

render_gateway_health

📖 read

Open the gateway health dashboard widget

render_virtual_servers

📖 read

Open the virtual server viewer widget

Requirements

  • Python 3.11+

  • uv for dependency management

  • Kubeconfig pointing to a cluster running mcp-gateway CRDs

  • (Optional) Port-forward to the broker for live status

Quick start

# Forward the broker port
kubectl port-forward svc/mcp-gateway -n mcp-gateway-system 8080:8080 &

# Install dependencies
uv sync

# Run (stdio — for Claude Desktop / Cursor)
uv run server.py --namespace mcp-servers --broker-url http://localhost:8080

# Run (HTTP — for MCP Inspector)
uv run server.py --transport http --namespace mcp-servers --broker-url http://localhost:8080

Item

Value

Gateway public URL

https://mcp.apps.hosted-services.ai5.appeng.rhecoeng.com

CRD namespace

mcp-servers

Broker service

svc/mcp-gateway in mcp-gateway-system (port 8080)

Registered servers

assisted-service-mcp (24 tools, prefix assisted_), insights-mcp (16 tools, prefix insights_)

Configuration

Flag

Env var

Default

Notes

--kubeconfig

KUBECONFIG

~/.kube/config

Falls back to in-cluster config

--namespace

MCP_ADMIN_NAMESPACE

mcp-servers

Namespace where CRDs live

--broker-url

MCP_BROKER_URL

http://localhost:8080

Broker /status endpoint

--transport

MCP_ADMIN_TRANSPORT

stdio

stdio or http

--addr

MCP_ADMIN_ADDR

:8899

HTTP bind address

Client config

{
  "mcpServers": {
    "mcp-admin": {
      "command": "uv",
      "args": ["run", "/path/to/mcp-gateway-mcp/server.py",
               "--namespace", "mcp-servers",
               "--broker-url", "http://localhost:8080"]
    }
  }
}
{
  "mcpServers": {
    "gateway-admin": {
      "command": "uv",
      "args": ["run", "/path/to/mcp-gateway-mcp/server.py",
               "--namespace", "mcp-servers",
               "--broker-url", "http://localhost:8080"]
    }
  }
}

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcpstead

    ahkohd
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP Gateway that aggregates multiple upstream MCP servers into a single endpoint with persistent connections, tool registry, and authentication.
    21 npm
    2
    MIT

  • MCP Manager

    daniel3303
    A
    license
    Not graded
    quality
    B
    maintenance
    Self-hosted MCP proxy and aggregation platform. Register multiple upstream MCP servers and expose them through a single unified endpoint with namespace routing, multi-transport support (HTTP/SSE, stdio, OpenAPI→MCP), per-tool overrides, and a web admin UI.
    17
    MIT

  • Mavryn

    Dnakitare
    A
    license
    Not graded
    quality
    C
    maintenance
    Centralized MCP control plane that proxies multiple upstream MCP servers with tool namespacing, filtering, policy enforcement, audit logging, and health checks.
    6 npm
    MIT

  • litellm-mcp

    nikitatsym
    A
    license
    A
    quality
    A
    maintenance
    MCP server for the LiteLLM proxy, enabling agents to administer resources like keys, teams, users, models, and proxy settings through risk-graded meta-tools.
    6
    MIT