fc-client-docker 0.9.2__tar.gz → 0.9.3__tar.gz

{fc_client_docker-0.9.2 → fc_client_docker-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fc_client_docker
-Version: 0.9.2
+Version: 0.9.3
 Summary: Dockerized wrapper for the FC client
 Home-page: https://github.com/NXP/fc
 Author: Larry Shen

{fc_client_docker-0.9.2 → fc_client_docker-0.9.3}/fc_client_docker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fc_client_docker
-Version: 0.9.2
+Version: 0.9.3
 Summary: Dockerized wrapper for the FC client
 Home-page: https://github.com/NXP/fc
 Author: Larry Shen

fc_client_docker-0.9.3/fc_common/VERSION

@@ -0,0 +1 @@
+0.9.3

{fc_client_docker-0.9.2 → fc_client_docker-0.9.3}/fc_mcp/README.md

@@ -77,6 +77,7 @@ in containers/services without CLI arguments. CLI flags take precedence.
 | `--host`      | `FC_MCP_HOST`        | `127.0.0.1` | Bind host (HTTP transport only).                   |
 | `--port`      | `FC_MCP_PORT`        | `8000`      | Bind port (HTTP transport only).                   |
 | `--path`      | `FC_MCP_PATH`        | `/mcp`      | URL path the MCP endpoint is served on (HTTP only).|
+| `--workdir`   | `FC_MCP_WORKDIR`     | _(unset)_   | Working directory for the server. Created automatically if missing. Supports `~`/`$VAR`. |
 | _(none)_      | `FC_MCP_AUTH_TOKEN`  | _(unset)_   | Static Bearer token for HTTP transport (env only). |
 
 Example using environment variables:
@@ -89,6 +90,30 @@ fc-mcp
 # -> http://0.0.0.0:9000/mcp
 ```
 
+### Working directory
+
+By default the server runs in whatever directory the launching process is in
+(for stdio this is the MCP client's working directory). Set `FC_MCP_WORKDIR`
+to force a specific working directory. This is where generated artifacts (for
+example flash/U-Boot helper scripts) are written.
+
+- The directory is created automatically (including parent directories) if it
+  does not exist.
+- `~` and `$VAR` are expanded, so a shared config works per user. For shell
+  configs prefer `$HOME/...` (the shell expands it at assignment); the server
+  also expands `~`/`$VAR` itself as a fallback, so both resolve to the running
+  user's home directory.
+- If the directory cannot be created or entered (permissions, path is a file),
+  a warning is printed and the current directory is kept, so startup is never
+  blocked.
+
+```bash
+# Any of these resolve to the running user's home-based directory:
+export FC_MCP_WORKDIR="$HOME/fc_mcp_work"   # recommended (shell expands $HOME)
+export FC_MCP_WORKDIR="~/fc_mcp_work"        # expanded by the server
+fc-mcp
+```
+
 ## Authentication (HTTP transport)
 
 By default the HTTP endpoint is **unauthenticated** — anyone who can reach

{fc_client_docker-0.9.2 → fc_client_docker-0.9.3}/fc_mcp/mcp_server.py

@@ -144,17 +144,42 @@ def _default_idle_timeout():
         return 3600
 
 
+def _apply_workdir(workdir):
+    """Change cwd to FC_MCP_WORKDIR/--workdir, creating it if needed."""
+    if not workdir:
+        return
+
+    path = os.path.abspath(os.path.expanduser(os.path.expandvars(workdir)))
+    try:
+        os.makedirs(path, exist_ok=True)
+        os.chdir(path)
+        print(f"FC MCP working directory set to: {path}", file=sys.stderr)
+    except OSError as exce:
+        print(f"Warning: cannot use workdir '{path}': {exce}", file=sys.stderr)
+
+
 def parse_args():
     """Parse command line arguments for transport selection.
 
     Environment variables provide the defaults so the server can be
     configured in containerized/service deployments without CLI flags:
-      FC_MCP_TRANSPORT, FC_MCP_HOST, FC_MCP_PORT, FC_MCP_PATH, FC_MCP_IDLE_TIMEOUT
+      FC_MCP_TRANSPORT, FC_MCP_HOST, FC_MCP_PORT, FC_MCP_PATH,
+      FC_MCP_IDLE_TIMEOUT, FC_MCP_WORKDIR
     """
     parser = argparse.ArgumentParser(
         prog="fc-mcp",
         description="FC MCP Server (supports stdio and streamable HTTP transports).",
     )
+    parser.add_argument(
+        "--workdir",
+        default=os.environ.get("FC_MCP_WORKDIR"),
+        help=(
+            "Working directory for the server. Created automatically if it "
+            "does not exist. Supports '~' and '$VAR' expansion. "
+            "Env: FC_MCP_WORKDIR."
+        ),
+    )
+
     parser.add_argument(
         "--transport",
         choices=["stdio", "http"],
@@ -231,10 +256,13 @@ def _configure_http_auth():
 def main():
     args = parse_args()
 
+    _apply_workdir(args.workdir)
+
     if args.transport == "http":
         # Streamable HTTP transport for remote/third-party MCP clients.
         # Clients connect to http://<host>:<port><path>, e.g. http://127.0.0.1:8000/mcp
         Logger.init("fc_mcp", log_name="mcp_server.log")
+
         _configure_http_auth()
 
         idle_monitor = None

fc_client_docker-0.9.2/fc_common/VERSION

@@ -1 +0,0 @@
-0.9.2