Add examples for using 'form-data' in multipart requests

Author: iFurySt

docs/configuration/gateways.md

@@ -53,7 +53,7 @@ tools:
       Cookie: "{{.Config.Cookie}}"                          # 使用服务配置中的值
     args:                         # 参数配置
       - name: "username"          # 参数名称
-        position: "body"          # 参数位置：header, query, path, body
+        position: "body"          # 参数位置：header, query, path, body, form-data
         required: true            # 参数是否必填
         type: "string"            # 参数类型
         description: "Username"   # 参数描述
@@ -158,6 +158,32 @@ tools:
           "tags": {{.Response.Data.preferences.tags}}
         }
       }
+
+  - name: "update_user_avatar"
+    description: "Update user avatar using a URL via multipart form"
+    method: "POST"
+    endpoint: "http://localhost:5236/users/{{.Args.email}}/avatar"
+    headers:
+      Authorization: "{{.Request.Headers.Authorization}}"
+      Cookie: "{{.Config.Cookie}}"
+    args:
+      - name: "email"
+        position: "path"
+        required: true
+        type: "string"
+        description: "Email of the user"
+        default: ""
+      - name: "url"
+        position: "form-data"
+        required: true
+        type: "string"
+        description: "The avatar image URL"
+        default: ""
+    responseBody: |-
+      {
+        "message": "{{.Response.Data.message}}",
+        "avatarUrl": "{{.Response.Data.avatarUrl}}"
+      }
 ```
 
 ## 配置说明
@@ -246,7 +272,7 @@ tools:
       Cookie: "{{.Config.Cookie}}"                          # 使用服务配置中的值
     args:                         # 参数配置
       - name: "username"          # 参数名称
-        position: "body"          # 参数位置：header, query, path, body
+        position: "body"          # 参数位置：header, query, path, body, form-data
         required: true            # 参数是否必填
         type: "string"            # 参数类型
         description: "Username"   # 参数描述
@@ -351,6 +377,32 @@ tools:
           "tags": {{.Response.Data.preferences.tags}}
         }
       }
+
+  - name: "update_user_avatar"
+    description: "Update user avatar using a URL via multipart form"
+    method: "POST"
+    endpoint: "http://localhost:5236/users/{{.Args.email}}/avatar"
+    headers:
+      Authorization: "{{.Request.Headers.Authorization}}"
+      Cookie: "{{.Config.Cookie}}"
+    args:
+      - name: "email"
+        position: "path"
+        required: true
+        type: "string"
+        description: "Email of the user"
+        default: ""
+      - name: "url"
+        position: "form-data"
+        required: true
+        type: "string"
+        description: "The avatar image URL"
+        default: ""
+    responseBody: |-
+      {
+        "message": "{{.Response.Data.message}}",
+        "avatarUrl": "{{.Response.Data.avatarUrl}}"
+      }
 ```
 
 #### 5.1 请求参数组装
@@ -360,7 +412,29 @@ tools:
 2. `.Args`: 直接从请求参数中提取值
 3. `.Request`: 从请求中提取的值，包括请求头`.Request.Headers`、请求体`.Request.Body`等
 
-组装在 `requestBody` 里面，比如：
+参数位置（position）支持以下几种：
+- `header`: 参数将被放置在请求头中
+- `query`: 参数将被放置在URL查询字符串中
+- `path`: 参数将被放置在URL路径中
+- `body`: 参数将被放置在JSON格式的请求体中
+- `form-data`: 参数将被放置在multipart/form-data格式的请求体中，用于文件上传等场景
+
+当使用 `form-data` 作为参数位置时，不需要指定 `requestBody`，系统会自动将参数组装成 multipart/form-data 格式。例如：
+
+```yaml
+  - name: "update_user_avatar"
+    method: "POST"
+    endpoint: "http://localhost:5236/users/{{.Args.email}}/avatar"
+    args:
+      - name: "url"
+        position: "form-data"
+        required: true
+        type: "string"
+        description: "The avatar image URL"
+```
+
+对于JSON格式的请求体，需要在 `requestBody` 中组装，比如：
+
 ```yaml
     requestBody: |-
       {
@@ -403,4 +477,3 @@ tools:
     - 每个配置单独存储为一个 YAML 文件
     - 类似 Nginx 的 vhost 配置方式
     - 文件名建议使用服务名称，如 `mock-user-svc.yaml`
-

i18n/de/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -173,17 +173,17 @@ Eine Konfiguration kann als Namespace betrachtet werden, empfohlen wird die Unte
 
 ### 2. Routing-Konfiguration
 
-Die Routing-Konfiguration wird verwendet, um Anforderungsweiterleitungsregeln zu definieren:
+Die Routing-Konfiguration wird verwendet, um Regeln für die Weiterleitung von Anfragen zu definieren:
 
 ```yaml
 routers:
-  - server: "mock-user-svc"     # Service-Name, muss mit name in servers übereinstimmen
-    prefix: "/mcp/user"         # Routenpräfix, global eindeutig, darf nicht dupliziert werden
+  - server: "mock-user-svc"     # Dienstname, muss mit Name in servers übereinstimmen
+    prefix: "/mcp/user"         # Routenpräfix, global eindeutig, kann nicht dupliziert werden
 ```
 
-Standardmäßig werden drei Endpunkte aus dem `prefix` abgeleitet:
+Standardmäßig werden drei Endpunkte vom `prefix` abgeleitet:
 - SSE: `${prefix}/sse`, z.B. `/mcp/user/sse`
-- SSE: `${prefix}/message`, z.B. `/mcp/user/message`
+- SSE Message: `${prefix}/message`, z.B. `/mcp/user/message`
 - StreamableHTTP: `${prefix}/mcp`, z.B. `/mcp/user/mcp`
 
 ### 3. CORS-Konfiguration

i18n/en/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -183,7 +183,7 @@ routers:
 
 By default, three endpoints will be derived from the `prefix`:
 - SSE: `${prefix}/sse`, e.g., `/mcp/user/sse`
-- SSE: `${prefix}/message`, e.g., `/mcp/user/message`
+- SSE Message: `${prefix}/message`, e.g., `/mcp/user/message`
 - StreamableHTTP: `${prefix}/mcp`, e.g., `/mcp/user/mcp`
 
 ### 3. CORS Configuration

i18n/es/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -173,18 +173,18 @@ Una configuración puede considerarse como un namespace, se recomienda diferenci
 
 ### 2. Configuración de Enrutamiento
 
-La configuración de enrutamiento se usa para definir reglas de reenvío de solicitudes:
+La configuración de enrutamiento se utiliza para definir las reglas de reenvío de solicitudes:
 
 ```yaml
 routers:
-  - server: "mock-user-svc"     # Nombre del servicio, debe coincidir con name en servers
-    prefix: "/mcp/user"         # Prefijo de ruta, globalmente único, no debe duplicarse
+  - server: "mock-user-svc"     # Nombre del servicio, debe coincidir con el nombre en servers
+    prefix: "/mcp/user"         # Prefijo de ruta, globalmente único, no puede duplicarse
 ```
 
-Por defecto, se derivan tres endpoints del `prefix`:
-- SSE: `${prefix}/sse`, ej. `/mcp/user/sse`
-- SSE: `${prefix}/message`, ej. `/mcp/user/message`
-- StreamableHTTP: `${prefix}/mcp`, ej. `/mcp/user/mcp`
+Por defecto, se derivarán tres puntos de conexión del `prefix`:
+- SSE: `${prefix}/sse`, por ejemplo, `/mcp/user/sse`
+- SSE Message: `${prefix}/message`, por ejemplo, `/mcp/user/message`
+- StreamableHTTP: `${prefix}/mcp`, por ejemplo, `/mcp/user/mcp`
 
 ### 3. Configuración CORS
 

i18n/fr/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -177,14 +177,14 @@ La configuration du routage est utilisée pour définir les règles de transfert
 
 ```yaml
 routers:
-  - server: "mock-user-svc"     # Nom du service, doit correspondre à name dans servers
-    prefix: "/mcp/user"         # Préfixe de route, globalement unique, ne doit pas être dupliqué
+  - server: "mock-user-svc"     # Nom du service, doit correspondre au nom dans servers
+    prefix: "/mcp/user"         # Préfixe de route, globalement unique, ne peut pas être dupliqué
 ```
 
-Par défaut, trois points de terminaison sont dérivés du `prefix` :
-- SSE: `${prefix}/sse`, ex. `/mcp/user/sse`
-- SSE: `${prefix}/message`, ex. `/mcp/user/message`
-- StreamableHTTP: `${prefix}/mcp`, ex. `/mcp/user/mcp`
+Par défaut, trois points de terminaison seront dérivés du `prefix` :
+- SSE : `${prefix}/sse`, par exemple, `/mcp/user/sse`
+- SSE Message : `${prefix}/message`, par exemple, `/mcp/user/message`
+- StreamableHTTP : `${prefix}/mcp`, par exemple, `/mcp/user/mcp`
 
 ### 3. Configuration CORS
 

i18n/hi/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -178,13 +178,13 @@ tools:
 ```yaml
 routers:
   - server: "mock-user-svc"     # सेवा का नाम, servers में name से मेल खाना चाहिए
-    prefix: "/mcp/user"         # रूट प्रीफिक्स, वैश्विक रूप से अद्वितीय, डुप्लिकेट नहीं होना चाहिए
+    prefix: "/mcp/user"         # रूट प्रीफिक्स, वैश्विक रूप से अद्वितीय, प्रतिलिपि नहीं हो सकता
 ```
 
-डिफ़ॉल्ट रूप से, `prefix` से तीन एंडपॉइंट व्युत्पन्न होते हैं:
-- SSE: `${prefix}/sse`, उदा. `/mcp/user/sse`
-- SSE: `${prefix}/message`, उदा. `/mcp/user/message`
-- StreamableHTTP: `${prefix}/mcp`, उदा. `/mcp/user/mcp`
+डिफ़ॉल्ट रूप से, `prefix` से तीन एंडपॉइंट निकाले जाएंगे:
+- SSE: `${prefix}/sse`, उदाहरण: `/mcp/user/sse`
+- SSE Message: `${prefix}/message`, उदाहरण: `/mcp/user/message`
+- StreamableHTTP: `${prefix}/mcp`, उदाहरण: `/mcp/user/mcp`
 
 ### 3. CORS कॉन्फ़िगरेशन
 

i18n/ja/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -171,19 +171,19 @@ tools:
 
 設定は名前空間と見なすことができ、サービスまたはドメインで区別することを推奨します。サービスには多くのAPIインターフェースが含まれ、各APIインターフェースは1つのToolに対応します
 
-### 2. ルーティング設定
+### 2. ルーティング構成
 
-ルーティング設定はリクエスト転送ルールを定義するために使用されます：
+ルーティング構成はリクエストの転送ルールを定義するために使用されます：
 
 ```yaml
 routers:
-  - server: "mock-user-svc"     # サービス名、serversのnameと一致する必要があります
-    prefix: "/mcp/user"         # ルートプレフィックス、グローバルで一意、重複不可
+  - server: "mock-user-svc"    # サービス名、serversのnameと一致する必要があります
+    prefix: "/mcp/user"        # ルートプレフィックス、グローバルに一意、重複不可
 ```
 
 デフォルトでは、`prefix`から3つのエンドポイントが派生します：
 - SSE: `${prefix}/sse`、例：`/mcp/user/sse`
-- SSE: `${prefix}/message`、例：`/mcp/user/message`
+- SSE Message: `${prefix}/message`、例：`/mcp/user/message`
 - StreamableHTTP: `${prefix}/mcp`、例：`/mcp/user/mcp`
 
 ### 3. CORS設定

i18n/ko/docusaurus-plugin-content-docs/current/configuration/gateways.md

@@ -178,12 +178,12 @@ tools:
 ```yaml
 routers:
   - server: "mock-user-svc"     # 서비스 이름, servers의 name과 일치해야 함
-    prefix: "/mcp/user"         # 라우트 접두사, 전역적으로 고유, 중복 불가
+    prefix: "/mcp/user"         # 라우트 접두사, 전역적으로 고유해야 하며 중복 불가
 ```
 
-기본적으로 `prefix`에서 세 가지 엔드포인트가 파생됩니다:
+기본적으로 `prefix`에서 3개의 엔드포인트가 파생됩니다:
 - SSE: `${prefix}/sse`, 예: `/mcp/user/sse`
-- SSE: `${prefix}/message`, 예: `/mcp/user/message`
+- SSE Message: `${prefix}/message`, 예: `/mcp/user/message`
 - StreamableHTTP: `${prefix}/mcp`, 예: `/mcp/user/mcp`
 
 ### 3. CORS 구성