DREAMVFIA Windows MCP

DREAMVFIA Windows MCP is a lean local Windows automation project with an MCP-style layout inspired by CursorTouch/Windows-MCP.

Project Layout

• src/dreamvfia_windows_mcp/automation: low-level mouse, keyboard, screenshot, and system helpers

• src/dreamvfia_windows_mcp/tools: MCP-style tool handlers

• src/dreamvfia_windows_mcp/tool_registry.py: tool metadata and dispatch

• src/dreamvfia_windows_mcp/server.py: FastMCP server builder

• src/dreamvfia_windows_mcp/cli.py: local CLI for listing tools, invoking tools, and serving MCP

• manifest.json and server.json: lightweight server metadata

Install

python -m pip install -e .

CLI Examples

python -m dreamvfia_windows_mcp tools
python -m dreamvfia_windows_mcp invoke Screenshot --arg output_path=capture.png
python -m dreamvfia_windows_mcp invoke Click --arg x=200 --arg y=300
python -m dreamvfia_windows_mcp invoke Clipboard --arg mode=set --arg text=hello
python -m dreamvfia_windows_mcp invoke Process --arg mode=list --arg limit=5

In PowerShell, prefer --arg key=value over --json to avoid quoting issues.

Included Tools

• App: launch an application or switch to a window by title

• Click: move and click at screen coordinates

• Clipboard: get or set clipboard text

• Move: move the mouse without clicking

• Process: list or kill Windows processes

• Screenshot: capture the current screen and return desktop context

• Scroll: vertical or horizontal scrolling

• Shortcut: send key combinations like ctrl+s

• System: return screen, mouse, and active window information

• Type: type text with optional Enter

• Wait: pause execution between steps

Run As MCP-style Server

dreamvfia-windows-mcp serve

If you prefer a regular install instead of editable mode, use python -m pip install ..