# wincore-mcp

MCP server exposing Windows desktop UI Automation as tools for AI agents, built on top of [appium-wincore-driver](https://github.com/verisoft-ai/appium-wincore-driver).

Previously shipped as `desktop-driver-mcp` inside `appium-wincore-driver`; now split into its own package so the MCP server and the Appium driver can be installed, versioned, and released independently.

## Prerequisites

- An Appium server running with `appium-wincore-driver` installed:

```bash
npm install -g appium
appium driver install --source=npm appium-wincore-driver
appium --port 4723
```

## Install

```bash
npm install -g wincore-mcp
```

or run directly with `npx wincore-mcp`.

## Configure

Environment variables (read at startup):

| Variable | Default | Description |
|---|---|---|
| `APPIUM_HOST` | `127.0.0.1` | Host of the running Appium server |
| `APPIUM_PORT` | `4723` | Port of the running Appium server |

## MCP client config

```json
{
  "mcpServers": {
    "wincore-mcp": {
      "command": "npx",
      "args": ["-y", "wincore-mcp"],
      "env": {
        "APPIUM_HOST": "127.0.0.1",
        "APPIUM_PORT": "4723"
      }
    }
  }
}
```

## Tools

See [docs/TOOLS.md](docs/TOOLS.md) for the full tool reference (~85 tools across session
management, element discovery, interaction, UIA patterns, window management, vision, and more),
generated from the current tool source.

## Development

```bash
npm install
npm run build
npm run test
npm run lint
```

## License

Apache-2.0