feat: Implement proper LocalTransport and RemoteTransport separation

Create clean separation with proper inheritance/composition:

- **LocalTransport**: Union of StdioTransport | StreamableHttpTransport | SseTransport
  - Used in Package context for local/package transports
  - Non-breaking rename of existing concepts

- **RemoteTransport**: Extends StreamableHttpTransport | SseTransport + variables
  - Reuses base transport definitions via allOf composition
  - Adds variables object for URL templating
  - Only supports streamable-http and sse (no stdio for remotes)

Benefits:
- ✅ Proper code reuse - shares StreamableHttp/Sse definitions
- ✅ Clear naming - LocalTransport vs RemoteTransport
- ✅ Non-breaking - just renames Package transport concept
- ✅ DRY design - no duplication between transport types
- ✅ Type safety - RemoteTransport can't use stdio

This addresses feedback about wanting proper inheritance and clearer
separation between local vs remote transport contexts.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: tadasant

docs/reference/server-json/server.schema.json

@@ -134,17 +134,7 @@
           ]
         },
         "transport": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/StdioTransport"
-            },
-            {
-              "$ref": "#/definitions/StreamableHttpTransport"
-            },
-            {
-              "$ref": "#/definitions/SseTransport"
-            }
-          ],
+          "$ref": "#/definitions/LocalTransport",
           "description": "Transport protocol configuration for the package"
         },
         "runtimeArguments": {
@@ -419,41 +409,73 @@
         }
       }
     },
-    "RemoteTransport": {
-      "type": "object",
-      "required": [
-        "type",
-        "url"
-      ],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": [
-            "streamable-http",
-            "sse"
-          ],
-          "description": "Remote transport type (only streamable-http and sse are supported for remote endpoints)"
+    "LocalTransport": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/StdioTransport"
         },
-        "url": {
-          "type": "string",
-          "description": "URL template for the remote transport. Variables in {curly_braces} reference variable names from the 'variables' object. If variables are not provided, {curly_braces} should be treated as literal text. After variable substitution, this should produce a valid URI.",
-          "example": "https://api.example.com/mcp/{tenant_id}"
+        {
+          "$ref": "#/definitions/StreamableHttpTransport"
         },
-        "headers": {
-          "type": "array",
-          "description": "HTTP headers to include",
-          "items": {
-            "$ref": "#/definitions/KeyValueInput"
-          }
+        {
+          "$ref": "#/definitions/SseTransport"
+        }
+      ],
+      "description": "Transport protocol configuration for local/package context"
+    },
+    "RemoteTransport": {
+      "anyOf": [
+        {
+          "allOf": [
+            {
+              "$ref": "#/definitions/StreamableHttpTransport"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "URL template for the streamable-http transport. Variables in {curly_braces} reference variable names from the 'variables' object. If variables are not provided, {curly_braces} should be treated as literal text. After variable substitution, this should produce a valid URI.",
+                  "example": "https://api.example.com/mcp/{tenant_id}"
+                },
+                "variables": {
+                  "type": "object",
+                  "description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",
+                  "additionalProperties": {
+                    "$ref": "#/definitions/Input"
+                  }
+                }
+              }
+            }
+          ]
         },
-        "variables": {
-          "type": "object",
-          "description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",
-          "additionalProperties": {
-            "$ref": "#/definitions/Input"
-          }
+        {
+          "allOf": [
+            {
+              "$ref": "#/definitions/SseTransport"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "Server-Sent Events endpoint URL template. Variables in {curly_braces} reference variable names from the 'variables' object. If variables are not provided, {curly_braces} should be treated as literal text. After variable substitution, this should produce a valid URI.",
+                  "example": "https://mcp-fs.example.com/sse/{tenant_id}"
+                },
+                "variables": {
+                  "type": "object",
+                  "description": "Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.",
+                  "additionalProperties": {
+                    "$ref": "#/definitions/Input"
+                  }
+                }
+              }
+            }
+          ]
         }
-      }
+      ],
+      "description": "Transport protocol configuration for remote context - extends StreamableHttpTransport or SseTransport with variables"
     },
     "ServerDetail": {
       "description": "Schema for a static representation of an MCP server. Used in various contexts related to discovery, installation, and configuration.",