# DREAMVFIA Windows MCP

DREAMVFIA Windows MCP is a lean local Windows automation project with an MCP-style layout inspired by [CursorTouch/Windows-MCP](https://github.com/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

```powershell
python -m pip install -e .
```

## CLI Examples

```powershell
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

```powershell
dreamvfia-windows-mcp serve
```

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