The kill-process-mcp
server allows you to manage OS processes using natural language commands through the MCP (Model Context Protocol).
Capabilities:
- List Processes: View running processes with advanced filtering options (by name, user, status, CPU/memory thresholds)
- Sort Processes: Order by CPU or memory usage (ascending or descending)
- Kill Processes: Terminate specific processes by PID
- Filtering Options: Include/exclude system processes, limit number of results
- Cross-Platform: Works on macOS, Windows, and Linux
- Natural Language Integration: Compatible with MCP clients like Claude Desktop for intuitive process management
Supports process management on Linux systems, allowing users to identify and terminate processes through natural language commands.
Enables listing and terminating processes running on macOS systems with filtering by CPU/memory usage, name, user, and other criteria.
Mentioned as an example use case where the MCP can be used to terminate Spotify processes by name.
kill-process-mcp 🔫
Cross-platform MCP (Model Context Protocol) server exposing tools to list and kill OS processes via natural language queries.
Perfect for shy ninjas who just want rogue processes gone!
"Find and nuke the damn CPU glutton choking my system!"
Demo
Tools
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 limitprocess_kill
: Terminates the selected process (with extreme prejudice!)
Requirements
- MCP-compatible LLM client (like Claude Desktop)
- OS: macOS/Windows/Linux
- Python 3.13 or higher
- uv
- Libraries:
mcp
psutil
Installation
1. Clone the repo and install
Install uv
if missing:
Install dependencies:
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:
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.
Example Hit Contracts
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 ...
Disclaimer
This MCP server is armed and dangerous. If you snipe the wrong process, that's on you.
Proceed with caution.
Change Log
See RELEASE_NOTES.md for details.
License
Licensed under GPLv3. See LICENSE.
local-only server
The server can only run on the client's local machine because it depends on local resources.
An MCP server that allows users to list and kill operating system processes through natural language queries, making process management more intuitive across Windows, macOS, and Linux.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.Last updated -1058PythonMIT License
- AsecurityAlicenseAqualityAn MCP server that provides tools for reading, writing, and editing files on the local filesystem.Last updated -11,387PythonApache 2.0
- -securityAlicense-qualityAn MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.Last updated -13JavaScriptMIT License
- -securityFlicense-qualityA Python-based MCP server that integrates with Plex Media Server API to search for movies and manage playlists in your Plex media library.Last updated -Python