# NTLite MCP Server

A [stdio MCP](https://modelcontextprotocol.io) server for [NTLite](https://ntlite.com). Connect it, point the AI at **your** Windows ISO (anywhere on disk), and say what you want.

Needs Windows, [NTLite](https://ntlite.com), and [Node.js 22.18+](https://nodejs.org/).

```powershell
git clone https://github.com/Dvow/ntlite-mcp.git
cd ntlite-mcp
npm install
```

Wire it like any other local MCP (interpreter + this repo’s TypeScript entry):

```json
{
  "mcpServers": {
    "ntlite-mcp": {
      "command": "node",
      "args": ["C:/path/to/ntlite-mcp/src/index.ts"]
    }
  }
}
```

Opening this folder in Cursor already uses `.cursor/mcp.json`. Set `NTLITE_EXE` only if NTLite is not under `%ProgramFiles%\NTLite`.

Open NTLite, give the AI your ISO path, and say what the finished install should be like. If that file is not on the Image tab, add it once. Dry-run first; apply needs confirmation. Output ISO defaults to `<name>-custom.iso` next to the source.

| Variable | Purpose |
| --- | --- |
| `NTLITE_EXE` | `NTLite.exe` if it is not under `%ProgramFiles%\NTLite` |
| `NTLITE_PRESETS` | Presets folder (defaults to NTLite’s Presets directory) |
| `NTLITE_MCP_WORKSPACE` | Extra presets folder (defaults to `Documents\NTLite-MCP`) |

## Documentation

- [Architecture](docs/architecture.md)
- [Tools](docs/tools.md)
- [NTLite CLI](docs/cli.md)
- [Preset XML](docs/preset-schema.md)
- [Limitations](docs/limitations.md)

## Development

```powershell
npm test
npm run typecheck
npm run inspector
```

## License

[Apache License 2.0](LICENSE).

NTLite MCP Server is an unofficial open-source project and is not affiliated with, endorsed by, or sponsored by NTLite or NTLite Software. It talks to a copy of NTLite that you install separately. Do not put NTLite binaries, license files, or other NTLite-copyrighted files in this repository.