From 33d73c9fed47274480bf5de91d823cab537eaef7 Mon Sep 17 00:00:00 2001
From: Jon <git@jonstarkey.co.uk>
Date: Sat, 2 May 2026 13:35:37 +0100
Subject: [PATCH] Server Scripts

---
 flipper-universal/flipper-universal-mcp.py | 55 ++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 flipper-universal/flipper-universal-mcp.py

diff --git a/flipper-universal/flipper-universal-mcp.py b/flipper-universal/flipper-universal-mcp.py
new file mode 100644
index 0000000..24695ba
--- /dev/null
+++ b/flipper-universal/flipper-universal-mcp.py
@@ -0,0 +1,55 @@
+from fastmcp import FastMCP
+import serial
+import time
+import os
+
+mcp = FastMCP("Flipper Zero - Universal CLI")
+FLIPPER_PORT = os.getenv("FLIPPER_PORT", "/dev/cu.usbmodemflip_Il1chih41")
+
+def send_flipper_cmd(cmd: str) -> str:
+    """Send ANY Flipper CLI command and return output"""
+    try:
+        with serial.Serial(FLIPPER_PORT, 115200, timeout=3) as ser:
+            time.sleep(0.5)  # let port settle
+            ser.reset_input_buffer()
+            
+            # Send command
+            ser.write((cmd + "\r\n").encode())
+            time.sleep(0.8)
+            
+            # Read response
+            output = ""
+            while ser.in_waiting:
+                output += ser.read(ser.in_waiting).decode(errors="ignore")
+                time.sleep(0.1)
+            
+            # Strip the command echo and prompt
+            lines = [l for l in output.splitlines() 
+                     if l.strip() and not l.strip().endswith(">:") and cmd not in l]
+            return "\n".join(lines) or f"Executed: {cmd}"
+            
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+@mcp.tool()
+def flipper(cmd: str):
+    """Send ANY Flipper CLI command. Examples:
+    - 'ir universal LG_Hotel_tv Power'  
+    - 'nfc scene read'
+    - 'subghz tx 433.92M test.sub'
+    - 'device_info'
+    - 'gpio pins'"""
+    return send_flipper_cmd(cmd)
+
+@mcp.tool()
+def flipper_ir(remote: str, signal: str):
+    """IR shortcut: flipper_ir('LG_Hotel_tv', 'Power')"""
+    return send_flipper_cmd(f"ir universal {remote} {signal}")
+
+@mcp.tool()
+def flipper_list_commands():
+    """List all available Flipper commands"""
+    return send_flipper_cmd("help")
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")
\ No newline at end of file