prepare documentation 0 3 0 (#325)

* uvenv -> uvx, add mcpgateway.translate and fast-time-server docs

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

* autoflake isort black

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

---------

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

Author: crivetimihai

.env.example

@@ -242,7 +242,7 @@ UNHEALTHY_THRESHOLD=3
 # Lock file Settings
 #####################################
 
-# This path is append with the system temp directory. 
+# This path is append with the system temp directory.
 # It is used to ensure that only one instance of the gateway health Check can run at a time.
 FILELOCK_NAME=gateway_healthcheck_init.lock   # saved dir in /tmp/gateway_healthcheck_init.lock
 # FILELOCK_NAME=somefolder/gateway_healthcheck_init.lock   # saved dir in /tmp/somefolder/gateway_healthcheck_init.lock#

DEVELOPING.md

@@ -5,20 +5,20 @@
 ```bash
 # Gateway & auth
 export MCP_GATEWAY_BASE_URL=http://localhost:4444
-export MCP_SERVER_CATALOG_URLS=http://localhost:4444/servers/1
+export MCP_SERVER_CATALOG_URLS=http://localhost:4444/servers/UUID_OF_SERVER_1
 export MCP_AUTH_TOKEN="<your_bearer_token>"
 ```
 
 | Mode                                                        | Command                                                                      | Notes                                                                         |
 | ----------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
 | **SSE (direct)**                                            | `npx @modelcontextprotocol/inspector`                                        | Connects straight to the Gateway's SSE endpoint.                              |
 | **Stdio wrapper** <br/>*(for clients that can't speak SSE)* | `npx @modelcontextprotocol/inspector python -m mcpgateway.wrapper`           | Spins up the wrapper **in-process** and points Inspector to its stdio stream. |
-| **Stdio wrapper via uv / uvenv**                            | `npx @modelcontextprotocol/inspector uvenv run python -m mcpgateway.wrapper` | Uses the lightning-fast `uv` virtual-env if installed.                        |
+| **Stdio wrapper via uv / uvx**                            | `npx @modelcontextprotocol/inspector uvx python -m mcpgateway.wrapper` | Uses the lightning-fast `uv` virtual-env if installed.                        |
 
 🔍 MCP Inspector boots at **[http://localhost:5173](http://localhost:5173)** - open it in a browser and add:
 
 ```text
-Server URL: http://localhost:4444/servers/1/sse
+Server URL: http://localhost:4444/servers/UUID_OF_SERVER_1/sse
 Headers:    Authorization: Bearer <your_bearer_token>
 ```
 
@@ -31,10 +31,8 @@ remote debugging or for clients that only understand SSE.
 
 ```bash
 # Using uvx (ships with uv)
-npx -y supergateway --stdio "uvx run mcp-server-git"
-# OR: using uvenv (pip-based)
-pip install uvenv
-npx -y supergateway --stdio "uvenv run mcp-server-git"
+pip install uv
+npx -y supergateway --stdio "uvx mcp-server-git"
 ```
 
 | Endpoint                 | Method | URL                                                            |

README.md

@@ -50,7 +50,7 @@ We implemented this by making the following changes:
 
 ## Consequences
 
-- Two gateways can have the tools with the same native name on the gateway. e.g. `gateway-1-get_current_time` and `gateway-2-get_current_time`.
+- Two gateways can have the tools with the same native name on the gateway. e.g. `gateway-1-get_system_time` and `gateway-2-get_system_time`.
 - If the tools on a gateway change, they will reflect after **Deactivate/Activate** cycle or after **Edit Gateway** action.
 
 ## Alternatives Considered

docs/docs/architecture/adr/011-tool-federation.md

@@ -674,7 +674,7 @@ Add this to your VS Code `settings.json`:
   "mcp.servers": {
     "mcp-gateway": {
       "type": "sse",
-      "url": "https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/1/sse",
+      "url": "https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/UUID_OF_SERVER_1/sse",
       "headers": {
         "Authorization": "Bearer <MCPGATEWAY_BEARER_TOKEN>"
       }
@@ -695,7 +695,7 @@ Add to your Claude Desktop configuration:
       "args": ["-m", "mcpgateway.wrapper"],
       "env": {
         "MCP_AUTH_TOKEN": "<MCPGATEWAY_BEARER_TOKEN>",
-        "MCP_SERVER_CATALOG_URLS": "https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/1"
+        "MCP_SERVER_CATALOG_URLS": "https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/UUID_OF_SERVER_1"
       }
     }
   }
@@ -708,7 +708,7 @@ Add to your Claude Desktop configuration:
 from mcpgateway_wrapper import MCPClient
 
 client = MCPClient(
-    catalog_urls=["https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/1"],
+    catalog_urls=["https://mcp-gateway.<CLUSTER_INGRESS_SUBDOMAIN>/servers/UUID_OF_SERVER_1"],
     token="<MCPGATEWAY_BEARER_TOKEN>",
 )
 

docs/docs/deployment/tutorials/argocd-helm-deployment-ibm-cloud-iks.md

@@ -16,7 +16,7 @@
 
 ???+ check "Python tooling"
     - [ ] `pip install --upgrade pip`
-    - [ ] `uv` and `uvenv` installed - [install uv](https://github.com/astral-sh/uv)
+    - [ ] `uv` and `uvx` installed - [install uv](https://github.com/astral-sh/uv)
     - [ ] `.venv` created with `make venv install install-dev`
 
 ???+ check "Additional tools"

docs/docs/development/developer-onboarding.md

@@ -3,14 +3,14 @@
 ## ⚡ Quickstart
 
 ???+ example "🚀 How can I install and run MCP Gateway in one command?"
-    PyPI (pipx / uvenv makes an isolated venv):
+    PyPI (pipx / uvx makes an isolated venv):
 
     ```bash
     # Using pipx - pip install pipx
     pipx run mcp-contextforge-gateway
 
-    # Or uvenv - pip install uvenv (default: admin/changeme)
-    uvenv run mcp-contextforge-gateway --port 4444
+    # Or uvx - pip install uv (default: admin/changeme)
+    uvx mcp-contextforge-gateway --port 4444
     ```
 
     OCI image (Docker/Podman) - shares host network so localhost works:
@@ -214,7 +214,7 @@
 
 ???+ example "🦾 How do I connect GitHub's mcp-server-git via SuperGateway?"
     ```bash
-    npx -y supergateway --stdio "uvx run mcp-server-git"
+    npx -y supergateway --stdio "uvx mcp-server-git"
     ```
 
 ---

docs/docs/faq/index.md

@@ -22,7 +22,7 @@ adding auth, caching, federation, and an HTMX-powered Admin UI.
     ```bash
     curl -N -H "Accept: text/event-stream" \
          -H "Authorization: Bearer $TOKEN" \
-         http://localhost:4444/servers/1/sse
+         http://localhost:4444/servers/UUID_OF_SERVER_1/sse
     ```
 
 ---

docs/docs/overview/features.md

@@ -154,8 +154,8 @@ Pick an install method below, generate an auth token, then walk through a real t
 
 ```bash
 # Spin up a sample MCP time server (SSE, port 8002)
-pip install uvenv
-npx -y supergateway --stdio "uvenv run mcp_server_time -- --local-timezone=Europe/Dublin" --port 8002 &
+pip install uv
+npx -y supergateway --stdio "uvx mcp_server_time -- --local-timezone=Europe/Dublin" --port 8002 &
 ```
 
 ```bash
@@ -183,7 +183,7 @@ curl -s -H "Authorization: Bearer $MCP_BEARER_TOKEN" http://localhost:4444/serve
 ```bash
 # Optional: Connect interactively via MCP Inspector
 npx -y @modelcontextprotocol/inspector
-# Transport SSE → URL http://localhost:4444/servers/1/sse
+# Transport SSE → URL http://localhost:4444/servers/UUID_OF_SERVER_1/sse
 # Header Authorization → Bearer $MCP_BEARER_TOKEN
 ```
 
@@ -193,7 +193,7 @@ npx -y @modelcontextprotocol/inspector
 
 ```bash
 export MCP_AUTH_TOKEN=$MCP_BEARER_TOKEN
-export MCP_SERVER_CATALOG_URLS=http://localhost:4444/servers/1
+export MCP_SERVER_CATALOG_URLS=http://localhost:4444/servers/UUID_OF_SERVER_1
 python -m mcpgateway.wrapper   # behaves as a local MCP stdio server - run from MCP client
 ```
 
@@ -206,7 +206,7 @@ Use this in GUI clients (Claude Desktop, Continue, etc.) that prefer stdio. Exam
       "command": "python3",
       "args": ["-m", "mcpgateway.wrapper"],
       "env": {
-        "MCP_SERVER_CATALOG_URLS": "http://localhost:4444/servers/1",
+        "MCP_SERVER_CATALOG_URLS": "http://localhost:4444/servers/UUID_OF_SERVER_1",
         "MCP_AUTH_TOKEN": "<YOUR_JWT_TOKEN>",
         "MCP_TOOL_CALL_TIMEOUT": "120"
       }

docs/docs/overview/quick_start.md

@@ -12,8 +12,8 @@
     You can use [`supergateway`](https://www.npmjs.com/package/supergateway) to wrap any `stdio`-only MCP server and expose it over SSE. Here are example commands:
 
     ```bash
-    npx -y supergateway --stdio "uvenv run mcp-server-git" --port 8001
-    npx -y supergateway --stdio "uvenv run mcp_server_time -- --local-timezone=Europe/Dublin"
+    npx -y supergateway --stdio "uvx mcp-server-git" --port 8001
+    npx -y supergateway --stdio "uvx mcp_server_time -- --local-timezone=Europe/Dublin"
     ```
 
     ✅ **Important:** The gateway must be able to reach the MCP server's network address.