refactor: migrate MCP SDK to main repo (#3516)

plugins/wasm-go/extensions/mcp-router/README_ZH.md

@@ -0,0 +1,89 @@
+# MCP Router 插件
+
+## 功能说明
+`mcp-router` 插件为 MCP (Model Context Protocol) 的 `tools/call` 请求提供了路由能力。它会检查请求负载中的工具名称，如果名称带有服务器标识符前缀（例如 `server-name/tool-name`），它会动态地将请求重新路由到相应的后端 MCP 服务器。
+
+这使得创建一个统一的 MCP 端点成为可能，该端点可以聚合来自多个不同 MCP 服务器的工具。客户端可以向单个端点发出 `tools/call` 请求，`mcp-router` 将确保请求到达托管该工具的正确底层服务器。
+
+## 配置字段
+
+| 名称 | 数据类型 | 填写要求 | 默认值 | 描述 |
+|---|---|---|---|---|
+| `servers` | 对象数组 | 是 | - | 每个后端 MCP 服务器的路由配置列表。 |
+| `servers[].name` | 字符串 | 是 | - | MCP 服务器的唯一标识符。这必须与 `tools/call` 请求的工具名称中使用的前缀相匹配。 |
+| `servers[].domain` | 字符串 | 否 | - | 后端 MCP 服务器的域名 (authority)。如果省略，将保留原始请求的域名。 |
+| `servers[].path` | 字符串 | 是 | - | 请求将被路由到的后端 MCP 服务器的路径。 |
+
+## 工作原理
+
+当一个启用了 `mcp-router` 插件的路由处理 `tools/call` 请求时，会发生以下情况：
+
+1.  **工具名称解析**：插件检查 JSON-RPC 请求中 `params` 对象的 `name` 参数。
+2.  **前缀匹配**：它检查工具名称是否遵循 `server-name/tool-name` 格式。
+    - 如果不匹配此格式，插件不执行任何操作，请求将正常继续。
+    - 如果匹配，插件将提取 `server-name` 和实际的 `tool-name`。
+3.  **路由查找**：提取的 `server-name` 用于从插件配置的 `servers` 列表中查找相应的路由配置（domain 和 path）。
+4.  **Header 修改**：
+    - `:authority` 请求头被替换为匹配的服务器配置中的 `domain`。
+    - `:path` 请求头被替换为匹配的服务器配置中的 `path`。
+5.  **请求体修改**：JSON-RPC 请求体中的 `name` 参数被更新为仅包含 `tool-name`（移除了 `server-name/` 前缀）。
+6.  **重新路由**：在 Header 修改后，网关的路由引擎会使用新的目标信息再次处理请求，将其发送到正确的后端 MCP 服务器。
+
+### 配置示例
+
+以下是在 `higress-plugins.yaml` 文件中配置 `mcp-router` 插件的示例：
+
+```yaml
+servers:
+- name: random-user-server
+  domain: mcp.example.com
+  path: /mcp-servers/mcp-random-user-server
+- name: rest-amap-server
+  domain: mcp.example.com
+  path: /mcp-servers/mcp-rest-amap-server
+```
+
+### 使用示例
+
+假设一个 `tools/call` 请求被发送到激活了 `mcp-router` 的端点：
+
+**原始请求:**
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "tools/call",
+  "params": {
+    "name": "rest-amap-server/get-weather",
+    "arguments": {
+      "location": "New York"
+    }
+  }
+}
+```
+
+**插件行为:**
+
+1.  插件识别出工具名称为 `rest-amap-server/get-weather`。
+2.  它提取出 `server-name` 为 `rest-amap-server`，`tool-name` 为 `get-weather`。
+3.  它找到匹配的配置：`domain: mcp.example.com`, `path: /mcp-servers/mcp-rest-amap-server`。
+4.  它将请求头修改为：
+    - `:authority`: `mcp.example.com`
+    - `:path`: `/mcp-servers/mcp-rest-amap-server`
+5.  它将请求体修改为：
+
+    ```json
+    {
+      "jsonrpc": "2.0",
+      "id": 2,
+      "method": "tools/call",
+      "params": {
+        "name": "get-weather",
+        "arguments": {
+          "location": "New York"
+        }
+      }
+    }
+    ```
+
+请求随后被重新路由到 `rest-amap-server`。