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 ..