Update mcp_filesystem demo

V2.37

Author: writePerfectCode

README.md

@@ -231,6 +231,24 @@ Example entry points you may want to run afterwards:
 .\build\mcp_filesystem_demo.exe
 ```
 
+Linux/macOS equivalents:
+
+```bash
+./build/func_registry_demo
+./build/json_invoke_demo
+./build/json_stateful_demo
+./build/json_tracing_demo
+./build/trace_recorder_demo
+./build/task_scheduler_demo
+./build/mcp_filesystem_demo
+```
+
+Cross-platform smoke test for the MCP filesystem demo:
+
+```bash
+pwsh -File ./examples/mcp_filesystem/mcp_filesystem_smoke.ps1
+```
+
 The initial configure step downloads `nlohmann/json` into `build/_deps/` through `FetchContent`. The HTTP gateway demo downloads `cpp-httplib` only when `LLM_INVOKE_CPP_BUILD_MCP_HTTP_DEMO` is enabled.
 
 GitHub Actions runs a Windows and Linux matrix for pushes and pull requests, covering configure/build/test plus smoke runs for the main non-server demos. The default CI path disables the HTTP gateway demo so the primary pipeline does not depend on downloading `cpp-httplib` during configure.

examples/mcp_filesystem/README.md

@@ -24,12 +24,31 @@ From the repository root:
 .\build\mcp_filesystem_demo.exe
 ```
 
+Linux/macOS:
+
+```bash
+./build/mcp_filesystem_demo
+```
+
 Quick smoke test (recommended):
 
+```powershell
+pwsh -File .\examples\mcp_filesystem\mcp_filesystem_smoke.ps1
+```
+
+On Windows, prefer `pwsh` (PowerShell 7+) for the same command surface as Linux/macOS.
+If `pwsh` is not installed, this script also runs with Windows PowerShell 5.1:
+
 ```powershell
 powershell -ExecutionPolicy Bypass -File .\examples\mcp_filesystem\mcp_filesystem_smoke.ps1
 ```
 
+Linux/macOS:
+
+```bash
+pwsh -File ./examples/mcp_filesystem/mcp_filesystem_smoke.ps1
+```
+
 This script launches the demo, performs MCP initialize and tools/list, and prints PASS/FAIL.
 
 When startup succeeds, the server writes this readiness line to stderr:

examples/mcp_filesystem/mcp_filesystem_smoke.ps1

@@ -1,10 +1,21 @@
 param(
-    [string]$ExePath = ".\build\mcp_filesystem_demo.exe"
+    [string]$ExePath
 )
 
 Set-StrictMode -Version Latest
 $ErrorActionPreference = "Stop"
 
+if ([string]::IsNullOrWhiteSpace($ExePath)) {
+    # Windows PowerShell 5.1 does not define $IsWindows/$IsLinux/$IsMacOS.
+    $isWindowsPlatform = $true
+    $isWindowsVar = Get-Variable -Name IsWindows -ErrorAction SilentlyContinue
+    if ($null -ne $isWindowsVar) {
+        $isWindowsPlatform = [bool]$isWindowsVar.Value
+    }
+    $exeName = if ($isWindowsPlatform) { "mcp_filesystem_demo.exe" } else { "mcp_filesystem_demo" }
+    $ExePath = Join-Path (Join-Path "." "build") $exeName
+}
+
 # ── display helpers ───────────────────────────────────────────────────────────
 
 function Write-Header([string]$Title) {

examples/mcp_http/README.md

@@ -19,12 +19,24 @@ cmake --build build --target mcp_http_gateway_demo mcp_filesystem_demo
 .\build\mcp_http_gateway_demo.exe --host 127.0.0.1 --port 18084 --backend-executable .\build\mcp_filesystem_demo.exe
 ```
 
+Linux/macOS:
+
+```bash
+./build/mcp_http_gateway_demo --host 127.0.0.1 --port 18084 --backend-executable ./build/mcp_filesystem_demo
+```
+
 ## Run The Python Client
 
 ```powershell
 python .\examples\mcp_http\mcp_http_client_demo.py --base-url http://127.0.0.1:18084
 ```
 
+Linux/macOS:
+
+```bash
+python3 ./examples/mcp_http/mcp_http_client_demo.py --base-url http://127.0.0.1:18084
+```
+
 The client will:
 
 1. POST `initialize` to `/mcp`
@@ -42,6 +54,12 @@ Set `DEEPSEEK_API_KEY` in your environment first, then run:
 python .\examples\mcp_http\run_deepseek_mcp_http_chat.py --base-url http://127.0.0.1:18084 --prompt "List the files in the examples directory and tell me what you find."
 ```
 
+Linux/macOS:
+
+```bash
+python3 ./examples/mcp_http/run_deepseek_mcp_http_chat.py --base-url http://127.0.0.1:18084 --prompt "List the files in the examples directory and tell me what you find."
+```
+
 ## Notes
 
 - This path is MCP over HTTP, not stdio.