Kill Process MCP

🚀 kill-process-mcp 🔫

Cross-platform MCP (Model Context Protocol) server that provides tools to list and kill OS processes through natural language queries.

It's perfect for those who just want to get rid of rogue processes quietly!

"Find and nuke the damn CPU glutton choking my system!"

🚀 Quick Start

Demo

✨ Features

The following tools are exposed to MCP clients:

• process_list: Lists running processes sorted by CPU or memory with optional name, user, status, CPU/memory thresholds, system-process filtering, sort order and limit
• process_kill: Terminates the selected process (with extreme prejudice!)

📦 Installation

1. Clone the repo and install

git clone https://github.com/misiektoja/kill-process-mcp.git
cd kill-process-mcp

Install uv if missing:

pip install uv

# or on macOS: 
brew install uv

Install dependencies:

uv sync

2. Configure MCP Client

Register the kill-process-mcp as an MCP server in your client. For example, in Claude Desktop add the following to claude_desktop_config.json file:

{
    "mcpServers":
    {
        "kill-process-mcp":
        {
            "command": "uv",
            "args":
            [
                "run",
                "--directory",
                "/path/to/kill-process-mcp",
                "kill_process_mcp.py"
            ],
            "type": "stdio"
        }
    }
}

Default claude_desktop_config.json location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Replace /path/to/kill-process-mcp with the actual path of your project folder (remember to escape backslash characters if you're on Windows, e.g.: C:\\path\\to\\kill-process-mcp)

Restart your LLM client and it should be able to talk to the kill-process-mcp server.

In Claude Desktop you can check if the server is installed by going to Profile → Settings → Integrations.

💻 Usage Examples

Here are some example prompts you can use with your MCP-compatible AI assistant when interacting with this MCP server:

• Kill the damn process slowing down my system!
• Check my top 5 CPU parasites and flag any that look like malware
• List the 3 greediest processes by RAM usage
• Exterminate every process with Spotify in its name
• List Alice's Python processes, max 10 entries
• Which processes are over 2% CPU and 100 MB RAM
• anything else your imagination brings ...

📚 Documentation

Requirements

• MCP-compatible LLM client (like Claude Desktop)
• OS: macOS/Windows/Linux
• Python 3.13 or higher
• uv
• Libraries: mcp psutil

📄 License

Licensed under GPLv3. See LICENSE.

📚 Change Log

See RELEASE_NOTES.md for details.

⚠️ Important Note

This MCP server is armed and dangerous. If you snipe the wrong process, that's on you. Proceed with caution.