Metadata-Version: 2.4
Name: love-wmcp
Version: 1.0.1
Summary: Windows MCP Daemon — 74-tool AI operating system for Windows. Screen capture, browser automation (CDP), native app control (UIA), file operations, clipboard, process management, and Premiere Pro integration. Patent 10: Cross-Instance AI Coordination Protocol.
Project-URL: Homepage, https://tascan.io
Project-URL: Repository, https://github.com/mikelove2nd/love-wmcp
Project-URL: Bug Tracker, https://github.com/mikelove2nd/love-wmcp/issues
Project-URL: Documentation, https://tascan.io
Author-email: Michael Edward Love II <Michael@TaScan.io>
License: MIT
Keywords: ai,automation,browser-automation,cdp,claude,love-technologies,mcp,premiere-pro,screen-capture,uia,windows
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.4
Requires-Dist: flask>=2.3
Requires-Dist: mss>=9.0
Requires-Dist: pillow>=10.0
Requires-Dist: psutil>=5.9
Requires-Dist: pywin32>=306
Provides-Extra: all
Requires-Dist: playwright>=1.40; extra == 'all'
Requires-Dist: pywinauto>=0.6.8; extra == 'all'
Provides-Extra: browser
Requires-Dist: playwright>=1.40; extra == 'browser'
Provides-Extra: uia
Requires-Dist: pywinauto>=0.6.8; extra == 'uia'
Description-Content-Type: text/markdown

# love-wmcp

**Windows MCP Daemon** — A 74-tool AI operating system for Windows by Love Technologies.

Give any AI agent full control of a Windows desktop: screen capture, browser automation, native app control, file management, and more. Built for Claude but works with any MCP-compatible client.

**Patent 10: Cross-Instance AI Coordination Protocol via Universal Task Record Bus**

## Three Components

| Component | Command | Port | Description |
|-----------|---------|------|-------------|
| **Daemon** | `wmcp-daemon` | 8765 | Persistent HTTP service. 74 tools. Screen buffer, window targeting, CDP, UIA. |
| **Remote** | `wmcp-remote` | 8766 | FastMCP/SSE server. 42 tools. Cloudflare Tunnel ready for remote access. |
| **Bridge** | `wmcp` | stdio | CLI tool. Routes to daemon (HTTP) or windows-mcp (stdio) based on tool name. |

## 74 Tools Across 6 Categories

### Screen / Window (Frame Buffer)
Continuous background screen capture with ring buffer. Target specific windows or full desktop.

### App / Process Management
Launch, focus, close, and enumerate applications.

### File / Clipboard
Read, write, append files. Get/set clipboard contents.

### Browser Automation (Chrome DevTools Protocol)
Full browser control via CDP on port 9222. No pixel coordinates needed — click by text or selector.

### Native UI Automation (UIA / pywinauto)
Control native Windows applications by element name, automation ID, or control type.

### Premiere Pro Integration
Remote control Adobe Premiere Pro for video editing workflows.

## Install

```bash
pip install love-wmcp

# With browser automation (Playwright/CDP)
pip install love-wmcp[browser]

# With native UI automation (pywinauto)
pip install love-wmcp[uia]

# Everything
pip install love-wmcp[all]
```

## Security: API Key Required

**`wmcp-remote` exposes shell execution, filesystem access, clipboard, screen capture, and browser control. Anyone who reaches it gets full RCE on the host.** As of `1.0.1`, the remote server **refuses to start** without an API key.

```bash
# Generate a strong token
python -c "import secrets; print(secrets.token_urlsafe(48))"

# Set it before starting (PowerShell)
$env:WMCP_API_KEY = "<paste-token-here>"
wmcp-remote

# Clients must send the same token on every request
# Authorization: Bearer <token>
```

Never expose `wmcp-remote` to the internet without setting `WMCP_API_KEY`. The local daemon (`wmcp-daemon`, port 8765) is bound to `127.0.0.1`; the remote server (port 8766) is the one that needs auth.

## Quick Start

```bash
# Start the daemon (local-only, port 8765)
wmcp-daemon

# Use the CLI bridge
wmcp wmcp_list_windows
wmcp wmcp_launch_app '{"name": "notepad"}'

# Start the remote MCP server (requires WMCP_API_KEY — see Security above)
$env:WMCP_API_KEY = "your-token"
wmcp-remote
```

## Remote Access (Cloudflare Tunnel)

```bash
$env:WMCP_API_KEY = "your-token"
wmcp-daemon &
wmcp-remote &
cloudflared tunnel run wmcp
```

The remote server exposes 42 tools via Streamable HTTP on port 8766 with mandatory Bearer-token auth. Point a Cloudflare Tunnel at it for remote AI-to-machine communication.

## Requirements

- **Windows 10/11**
- **Python >= 3.10**
- **Chrome** (for CDP browser tools, started with `--remote-debugging-port=9222`)

## Part of the Love Technologies Ecosystem

- **TaScan** — Universal task protocol. [tascan.io](https://tascan.io)
- **The Council** — Multi-LLM adversarial consensus engine
- **CCSP** — Persistent AI identity infrastructure
- **10 provisional patents filed** (265 claims)

## License

MIT

## Author

Michael Edward Love II — Michael@TaScan.io — Love Technologies
