Add examples/mcp/ with launcher and Claude Desktop sample config

Three-variant Claude Desktop config (console script, python -m, standalone
script) plus run_mcp.py launcher and a setup README. Gives users a
ready-to-copy starting point for registering the automation_file MCP
server with any MCP host.

Author: JE-Chen

examples/mcp/README.md

@@ -0,0 +1,41 @@
+# automation_file MCP server
+
+Three ways to launch the MCP stdio bridge, in order of preference:
+
+```bash
+automation_file_mcp                                # installed console script
+python -m automation_file mcp                      # CLI subcommand
+python examples/mcp/run_mcp.py                     # standalone launcher
+```
+
+All three accept the same flags:
+
+| Flag                 | Default            | Description                                    |
+|----------------------|--------------------|------------------------------------------------|
+| `--name`             | `automation_file`  | `serverInfo.name` returned at handshake        |
+| `--version`          | `1.0.0`            | `serverInfo.version` returned at handshake     |
+| `--allowed-actions`  | *(all)*            | Comma-separated allow list (e.g. `FA_file_checksum,FA_fast_find`) |
+
+## Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+- **Windows** — `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**  — `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+`claude_desktop_config.json` in this directory is a ready-to-copy sample
+covering the three launch styles. Pick the one that matches your install.
+
+## Manual smoke test
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | automation_file_mcp
+```
+
+A single line reply containing `serverInfo` means the server is healthy.
+
+## Security
+
+`--allowed-actions` is strongly recommended. The default registry includes
+`FA_run_shell`, `FA_encrypt_file`, and other high-privilege actions that an
+MCP host may invoke without prompting.

examples/mcp/claude_desktop_config.json

@@ -0,0 +1,28 @@
+{
+  "mcpServers": {
+    "automation_file": {
+      "command": "automation_file_mcp",
+      "args": [
+        "--allowed-actions",
+        "FA_file_checksum,FA_verify_checksum,FA_fast_find,FA_sync_dir"
+      ]
+    },
+    "automation_file_full": {
+      "command": "python",
+      "args": [
+        "-m",
+        "automation_file",
+        "mcp"
+      ],
+      "env": {
+        "PYTHONIOENCODING": "utf-8"
+      }
+    },
+    "automation_file_script": {
+      "command": "python",
+      "args": [
+        "C:/absolute/path/to/examples/mcp/run_mcp.py"
+      ]
+    }
+  }
+}

examples/mcp/run_mcp.py

@@ -0,0 +1,27 @@
+"""Minimal MCP stdio launcher.
+
+Point an MCP host at this file with::
+
+    {
+      "mcpServers": {
+        "automation_file": {
+          "command": "python",
+          "args": ["/absolute/path/to/examples/mcp/run_mcp.py"]
+        }
+      }
+    }
+
+For a whitelisted registry prefer the installed console script
+``automation_file_mcp --allowed-actions FA_list_dir,FA_file_checksum`` or
+``python -m automation_file mcp --allowed-actions ...``.
+"""
+
+from __future__ import annotations
+
+import sys
+
+from automation_file.server.mcp_server import _cli
+
+
+if __name__ == "__main__":
+    sys.exit(_cli())