feom-mcp 0.1.1

OS-native Windows GUI automation MCP server. Zero GPU, zero API tokens.

🏆 Front-End Operation Master (FEOM)

The Ultimate Front-End OS Engine for AI Agents. 0 Vision Tokens. 733× Faster. 100% Deterministic.

FEOM is a production-grade front-end operation architecture for Windows AI Agents. This repository contains the Open-Core Edition, allowing developers to test and verify real-time structural OS routing (achieving ~8ms background UIA invocation), completely eliminating VLM vision token costs.

📊 Feature Matrix: Open-Core vs Pro/Enterprise

Feature	🟡 Open-Core (This Repo)	🟢 FEOM Pro / Enterprise
MCP Server Framework	✅ Included	✅ Included
UIA Tree Structural Read	✅ Included (~75ms)	🚀 Predictive Async Cache (<1ms)
Win32 SendInput Click	🟢 Standard (~3.96ms)	⚡ Zero-Alloc UltraClick (<1.0ms)
Background UIA Invoke	🟢 Basic (~8ms)	⚡ Win32 PostMessage (~1ms)
Multi-Monitor High DPI	❌ Static Coords Only	✅ Dynamic Scaling Matrix
Taskbar Push Auto-Recovery	❌ Fixed Offsets	✅ Icon Vector Tracking
Input Pipeline Optimization	❌ Raw Character Streams	✅ Clipboard Parallel (-71%)

---

🥇 The Three Iron Rules of Production Automation

1. Unique Truth: Front-End Demonstration Over Everything

Always show, then report. Every sequence must execute visibly in the foreground.

2. Safety First: Pre-Action Focus Defending

Never click blindly. Structural state verification is forced prior to any input.

3. App Termination Rule: Strict Alt+F4 Ban

Alt+F4 blindly kills whatever window has focus — frequently closing the orchestration engine itself.

---

🚀 Hybrid Terminal+MCP Extreme Mode

Execution Stage	Traditional MCP Agent	FEOM Hybrid Mode	Time Saved
App Bootup	~3.0s (UI traversal)	0.01s	99.6%
Form Input	~5.0s (Vision Loop)	1.2s	76.0%
Close & Verify	~4.0s (Screenshot)	2.0s	50.0%
Total End-to-End	~12.0s	~3.21s	73.2% Faster

# Verify instant boot:
terminal("start calc")

---

Hardware Requirements (Killer Feature)

Requirement	Traditional VLM	FEOM Open-Core
GPU	RTX 3060+ required	None - any CPU works
RAM	16GB+	4GB
Network	Required (API per click)	Zero - fully local
Cost/op	$0.01-$0.05 (vision tokens)	$0
Display	Yes (needs screenshot)	No - works headless
Hardware cost	$1,000+ gaming PC	$50 used Dell
Annual license	$15K+ (RPA)	$0 (Open-Core)

Deterministic vs Probabilistic

	VLM Screenshot	FEOM OS-Native
Output	Coordinate guessing	AutomationID targeting
Repeatability	Different each time	100% identical
DPI scaling	Coordinates drift	UIA auto-maps
Background	Cannot work	Works minimized
Production-ready	Demo only	Production grade

💼 Commercial Licensing

Tier	Product	Price
1	Turbo-MCP Plugin (anti-crash + DPI matrix)	$14.99/mo
2	AI-SaaS Task Force (legacy ERP/CRM migration)	Custom
3	Enterprise Consulting (stability + multi-monitor audit)	$3K-$10K
4	Hermes-Split-OS SDK (parallel multi-agent framework)	License

Inquiries: Open B2B Ticket or [e-mail]

3-Line Quick Start

pip install pywinauto pywin32 mcp
python server.py

Then add to MCP client config:

{
  "mcpServers": {
    "feom": {
      "command": "python",
      "args": ["path/to/server.py"]
    }
  }
}

No GPU. No cloud API. No Docker. Any Windows PC.

Tools (Open-Core)

Tool	Description	Latency
feom_click	Click at screen coords via SendInput	~4ms
feom_uia_invoke	Invoke UIA element by AutomationID	~8ms
feom_launch	Launch app via terminal pipe	~0.01s
feom_list_windows	List all visible windows	~75ms

Quick Start

pip install pywinauto pywin32 mcp python server.py

---

Installation

Option 1: pip install (recommended)

pip install feom-mcp
python -m feom.server

Option 2: Clone and run

git clone https://github.com/a92070888-dev/mcp-os-native-automation.git
cd mcp-os-native-automation
pip install -r requirements.txt
python server.py

Option 3: UVX (MCP client auto-discovery)

{
  "mcpServers": {
    "feom": {
      "command": "uvx",
      "args": ["feom-mcp"]
    }
  }
}

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "feom": {
      "command": "python",
      "args": ["path/to/server.py"]
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "feom": {
      "command": "python",
      "args": ["path/to/server.py"]
    }
  }
}

Any MCP Client (stdio)

{
  "mcpServers": {
    "feom": {
      "command": "uvx",
      "args": ["feom-mcp"]
    }
  }
}

Verify Installation

python server.py
# Server starts on stdio. Expected output:
# FEOM MCP server ready

Requirements

• OS: Windows 10/11 only
• Python: 3.10+
• No GPU required
• No API keys required
• No Docker required

---

3-Line Quick Start