Build Unblocker MCP

A Model-Context-Protocol (MCP) server for Cursor IDE to terminate hung Windows build executables.

Features

Monitors specified build processes (cl.exe, link.exe, msbuild.exe, etc.)
Terminates processes that are idle (less than 1% CPU usage) for a configurable duration (default 90 seconds)
Provides a tool (unblock_build) for Cursor IDE to trigger the unblocking process

Ensure you have Python 3.11 or later installed.
Install using pipx (recommended for CLI tools):
pipx install .
Or using pip:
pip install .

Add the following to your Cursor IDE settings (settings.json):

{ "mcpServers": { "build-unblocker": { "command": "unblock-build-mcp" } } }

You can run the tool manually to test it (use --dry-run to avoid killing processes):

pipx run unblock-build-mcp --idle-seconds 5 --dry-run

CI Status (Replace

This project is licensed under the MIT License. See the LICENSE file for details.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work