https://github.com/misiektoja/kill-process-mcp
Cross-platform MCP (Model Context Protocol) server exposing tools to list and terminate OS processes via natural language queries
https://github.com/misiektoja/kill-process-mcp
kill-process llm mcp mcp-server
Last synced: 4 months ago
JSON representation
Cross-platform MCP (Model Context Protocol) server exposing tools to list and terminate OS processes via natural language queries
- Host: GitHub
- URL: https://github.com/misiektoja/kill-process-mcp
- Owner: misiektoja
- License: gpl-3.0
- Created: 2025-07-01T00:03:48.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-01T15:38:02.000Z (4 months ago)
- Last Synced: 2025-07-01T16:45:21.149Z (4 months ago)
- Topics: kill-process, llm, mcp, mcp-server
- Language: Python
- Homepage:
- Size: 19.4 MB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **kill-process-mcp** - List and terminate OS processes via natural language queries `http` `git` `github` (📦 Other)
- awesome-mcp-servers - **misiektoja/kill-process-mcp 🐍 🏠 🍎 🪟 🐧** - List and terminate OS processes via natural language queries `http` `git` `github` (Other)
README
# 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!"**
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!)
* MCP-compatible LLM client (like [Claude Desktop](https://claude.ai/download))
* OS: macOS/Windows/Linux
* Python 3.13 or higher
* [uv](https://github.com/astral-sh/uv)
* Libraries: `mcp` `psutil`
### 1. Clone the repo and install
```sh
git clone https://github.com/misiektoja/kill-process-mcp.git
cd kill-process-mcp
```
Install `uv` if missing:
```sh
pip install uv
# or on macOS:
brew install uv
```
Install dependencies:
```sh
uv sync
```
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:
```json
{
"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**.
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 ...**
This MCP server is armed and dangerous. If you snipe the wrong process, that's on you.
Proceed with caution.
See [RELEASE_NOTES.md](https://github.com/misiektoja/kill-process-mcp/blob/main/RELEASE_NOTES.md) for details.
Licensed under GPLv3. See [LICENSE](https://github.com/misiektoja/kill-process-mcp/blob/main/LICENSE).