winforms-mcp

The problem

You're building a WinForms app with an AI coding agent. The agent can read and write your code, but it's blind — it can't see what the form looks like, can't click a button to test a workflow, and can't tell if the UI it just generated actually renders correctly.

The fix

One line in your MCP config. Now the agent can:

Quick start

Claude Code plugin (easiest):

/plugin marketplace add fnrhombus/claude-plugins
/plugin install winforms-mcp@claude-plugins

MCP config with npx (requires Node.js):

{
  "mcpServers": {
    "winforms-mcp": {
      "command": "npx",
      "args": ["-y", "@fnrhombus/winforms-mcp"]
    }
  }
}

Standalone (no Node required) — download the zip from Releases, extract it, and point to the exe:

{
  "mcpServers": {
    "winforms-mcp": {
      "command": "C:/path/to/winformsmcp/winformsmcp.exe"
    }
  }
}

Note: Keep the extracted folder structure intact — render_form needs the rendererhost/ subdirectory alongside the exe.

That's it. The agent can now see and interact with any WinForms application on your machine.

Tools

Cross-framework rendering

render_form detects your project's target framework and dispatches to a matching out-of-process host — the same rendering pipeline Visual Studio uses, so custom controls and third-party components resolve correctly.

Framework-specific APIs resolve correctly too. Override with the TFM environment variable if needed.

Headless mode

Set HEADLESS=true to launch apps on a hidden Windows desktop (CreateDesktop API):

• Zero focus stealing — apps can't steal focus, show TopMost windows, or flash in the taskbar
• Full automation — element discovery, clicking, typing, and screenshots all work through UIA patterns and PrintWindow
• Mixed mode — headless and visible apps in the same session, each automatically routed to its correct desktop

{
  "mcpServers": {
    "winforms-mcp": {
      "command": "npx",
      "args": ["-y", "@fnrhombus/winforms-mcp"],
      "env": { "HEADLESS": "true" }
    }
  }
}

Note: send_keys and drag_drop require input simulation and only work on the visible desktop. Use type_text/set_value and click_element for headless processes.

Environment variables

Documentation

• Examples — common workflows and patterns
• Headless Mode — hidden desktop architecture and tool compatibility

Contributing

Contributions welcome — see issues for open items. Git hooks for commit validation and code formatting are configured automatically on first build.

Support

If you find this project useful, consider supporting its development:

• GitHub Sponsors — Monthly sponsorship with public recognition
• Buy Me a Coffee — One-time or recurring donations

Your support helps maintain and improve this project!

License

MIT