KillerMCP

One local MCP connection for KillerTools and the Killer app family: KillerPDF, KillerNotes, KillerScan, KillerShell, Killendar, KillerBench, and KillerShot.

KillerMCP is a native .NET 10 host. It detects supported Killer apps, exposes their available commands, and registers one MCP server with compatible agent clients. The separate KillerTools repository provides the shared engine for the website utilities.

Install

Download the signed KillerMCP installer, run setup, then open a new agent chat. Setup checks for the .NET 10 runtime and registers KillerMCP with Codex, Claude Code, Claude Desktop, Cursor, GitHub Copilot, Gemini CLI, and Windsurf when those clients are found.

You can also install it with WinGet or Chocolatey. Both install the .NET 10 Desktop Runtime for you when it is missing. The Microsoft Store version carries its own .NET runtime, so it needs nothing installed first.

winget install killermcp
choco install killermcp

Fully quit and reopen an agent client after setup or upgrade, then start a new chat. In Claude Desktop, KillerMCP appears under Settings > Developer as a running local server and under Connectors as a desktop connector. Cowork can use that local connection without a separate plugin.

Once connected, ask naturally:

• killer domain search example.com

• killer merge these PDFs

• killerscan my network

• killer update status

The server supplies tool descriptions and instructions that help the client select the appropriate tool. Client behavior varies, so these phrases are guidance rather than guaranteed commands.

KillerMCP checks GitHub Releases hourly and shows a Black/Fuchsia update window when a newer version is available. Choose whether future updates should stay off, check and ask, download and ask, or install automatically. Every downloaded installer must match the published SHA256 and pass Windows signature verification before it can run.

Related MCP server: Cupertino

What it includes

• All 81 KillerTools website utilities from the native KillerTools engine.

• Automatic tool discovery for supported versions of KillerPDF, KillerScan, KillerNotes, KillerShell, Killendar, KillerBench, and KillerShot.

• Safe migration from the earlier Node based KillerMCP installation and client registrations.

• Install, reinstall, repair, and uninstall behavior through the KillerUI styled Windows setup.

• A framework dependent native package for each supported operating system and processor architecture.

KillerPDF provides PDF editing, conversion, inspection, OCR, printing, and accessibility tools when the installed version advertises them. KillerScan provides local network details, bounded scans, host probes, offline MAC vendor lookup, ping, route tracing, diagnostics, availability watching, and KillerSpeed tests. KillerShell provides read-only file browsing, text reading, file hashing, process and service listings with optional detail and filter, event log reading, registry inspection, drive information, and a folder size report with KillerShell 1.5.1 or newer. KillerNotes can search, read, create, edit, organize, color, import images, inspect links and history, and export notes. Killendar provides agenda lookup and creates single appointments while its window is open and unlocked.

KillerShot takes screenshots, records MP4 or GIF, lists monitors, windows and recent captures, and opens images in its editor. Version 1.1.1 or newer also provides local OCR and QR reading, image edits into new files, recording controls, and capture-library search when its command line advertises them. PDF optimization's signature-invalidation option requires KillerPDF 1.9.1 or newer, so MCP can be updated before PDF.

KillerBench provides offline Windows code lookups, read-only checks and full diagnostic scans. It can also preview and run a fixed list of guarded Windows repairs. Repairs are off until you turn them on in the KillerMCP section of the KillerBench About window. Every repair needs a fresh preview and Windows administrator approval. Disruptive repairs, and the first repair after the repair setting is turned on or changed, also need your approval in a KillerMCP window on the desktop. See KillerBench for the full list and safeguards.

Cross app workflows can export a KillerNotes note, KillerScan network report, Killendar agenda, or KillerShell directory listing to PDF. They can also save scan, agenda, and directory reports as notes, or render selected KillerPDF pages into image notes.

See What KillerMCP can do for the complete tool guide, examples, limits, and data handling details.

For tool permissions and invocation logging, see Tool permissions and visibility and Tool call history.

Build from source

Clone this repository with its pinned KillerTools engine source:

git clone --recurse-submodules https://github.com/SteveTheKiller/KillerMCP.git
cd KillerMCP

Open KillerMCP.slnx at the repository root. The main app project, KillerMCP.csproj, includes the repository's source, assets, scripts, tests and documentation in Solution Explorer.

See Architecture for the project and request flow. To add the app to an existing Visual Studio solution, add KillerMCP.csproj and dependencies/KillerTools/src/KillerTools.Engine/KillerTools.Engine.csproj. Visual Studio needs the referenced engine project loaded for package restore.

Build and test the native host:

dotnet build KillerMCP.slnx -c Release
powershell -NoProfile -File scripts\Test-All.ps1

Build a framework dependent package for the current platform:

powershell -NoProfile -File scripts\Test-NativePackage.ps1

Build and test the Windows installer:

powershell -NoProfile -File scripts\Test-WindowsInstaller.ps1

The native host requires the .NET 10 runtime. The Windows installer checks for it before installation and links to the official Microsoft download when it is missing.

For development builds or custom app locations, set KILLERPDF_CLI, KILLERSCAN_CLI, KILLERNOTES_CLI, KILLENDAR_CLI, KILLERSHELL_CLI, KILLERBENCH_CLI, or KILLERSHOT_CLI to an absolute executable path. An invalid override leaves that app unavailable instead of silently selecting another copy.

Run powershell -NoProfile -File release.ps1 to build, sign, verify, publish to GitHub, and submit to Microsoft Store. The reviewed source must be on origin/main and the changelog entry must be dated for release. Run scripts\Test-All.ps1 separately for the full regression and installer suites. Use -DryRun to build and sign without tagging, publishing, or submitting to the Store. -SkipSign produces an unsigned local test build and never publishes or contacts the Store.

Public installers are published through KillerMCP releases.

License

KillerMCP is licensed under the GNU General Public License Version 3.