kill-process-mcp

kill-process-mcp

List and terminate OS processes via natural language queries

10
Stars
5
Forks
0
Releases

Overview

kill-process-mcp is a cross-platform MCP server exposing tools to list and kill OS processes via natural language queries. It provides two core tools: process_list, which lists running processes ordered by CPU or memory with optional filters such as name, user, status, CPU/memory thresholds, system-process filtering, and supports sort order and limit, and process_kill, which terminates the selected process (with extreme prejudice!). The server is designed to work with MCP-compatible LLM clients like Claude Desktop or Cursor and runs on macOS/Windows/Linux with Python 3.13+ and the uv runtime, relying on the mcp and psutil libraries. Installation supports two modes: the preferred uvx workflow with no cloning, or a manual clone-based setup. The README provides configuration examples to register the server with Claude Desktop and Cursor, including uvx and manual mode JSON snippets, and guidance for upgrading and troubleshooting. There are safety notes and an emphasis on practical process management, plus an optional persistent shim for faster startup. Overall, kill-process-mcp enables natural language-driven discovery and termination of system processes for proactive maintenance.

Details

Owner
misiektoja
Language
Python
License
GNU General Public License v3.0
Updated
2025-12-07

Features

List running processes with filters

process_list exposes a listing of running processes sorted by CPU or memory with optional name, user, status, CPU/memory thresholds, system-process filtering, sort order and limit.

Terminate processes via MCP

process_kill terminates the selected process (with extreme prejudice!).

Cross-platform support

Runs on macOS, Windows and Linux using Python 3.13+ and psutil.

MCP client exposure for natural language

Exposed to MCP clients (e.g., Claude Desktop, Cursor) to enable natural language queries.

Flexible deployment options

Install via the preferred uvx workflow with no cloning or clone the repo and install dependencies manually.

Auto-update and upgrades

When using uvx, it automatically fetches and runs the latest version on startup; upgrade steps are available for manual installs.

Audience

system administratorsManage rogue processes using natural language via an MCP assistant.
developersIntegrate process visibility and control into MCP-enabled assistants and workflows.
general usersInteract with OS processes using natural language to improve performance.

Tags

mcpkill-processprocess_listprocess_killos-processesnatural-languagecross-platformpsutiluvpythonmacOSWindowsLinux