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
Installation
- Ensure you have Python 3.11 or later installed.
- Install using pipx (recommended for CLI tools):
Or using pip:pipx install .pip install .
Cursor Integration
Add the following to your Cursor IDE settings (settings.json):
{
"mcpServers": {
"build-unblocker": {
"command": "unblock-build-mcp"
}
}
}
Local Smoke Test
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
Continuous Integration
(Replace your-github-username with your actual GitHub username and build-unblocker-mcp with the repository name)
License
This project is licensed under the MIT License. See the LICENSE file for details.