Skip to main content

MCP server to terminate hung Windows build executables.

Project description

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

  1. Ensure you have Python 3.11 or later installed.
  2. Install using pipx (recommended for CLI tools):
    pipx install .
    
    Or using pip:
    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

CI Status (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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_build_unblocker_mcp-0.1.0.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_build_unblocker_mcp-0.1.0-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_build_unblocker_mcp-0.1.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_build_unblocker_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7bd35f4c70ab3e70462bcf97521f3bc8dbccc591efeb0ae712c737c513b78a96
MD5 97688aac3cc74af480706489211288af
BLAKE2b-256 9e70a6550e693cb73769555358f79be769c04f437d984a673e74f873b52a6de8

See more details on using hashes here.

File details

Details for the file iflow_mcp_build_unblocker_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_build_unblocker_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3b8c442238bd36d19618dd66f979e942cd48aceef78c81f8ff720643a10a0e18
MD5 f46aec9ec8ec63dafaab896aa8b9db2b
BLAKE2b-256 36d45d6cb2fd4e4552f835738d67c5cc4fdf25bc1fb82c66bb83c3ff285dfb53

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page