mcpField
P
Procm

Procm

Local
github.com/coder-kaDeveloper Tools5Updated 21w ago
Repository

About Procm

Procm is an MCP server for managing processes launched by AI workflows. It gates process creation with an allowlist and supports lifecycle control and log retrieval.

Key features

  1. 01Allowlisted process creation
  2. 02Start and restart processes
  3. 03Stop and remove processes
  4. 04Inspect process status
  5. 05Retrieve stdout and stderr

Use cases

  1. 01Run development servers for agent workflows
  2. 02Start test watchers and inspect their output

MCP support

Exposes process creation, lifecycle, status, and log operations as MCP tools. Creation can be restricted to approved commands and working directories.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "coder-ka-procm": {
      "command": "npx",
      "args": [
        "-y",
        "procm-mcp"
      ]
    }
  }
}
Run commandnpx -y procm-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmprocm-mcp0.0.43

Tools

11

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

procm-mcp

A Model Context Protocol (MCP) server for process management.

Supported features

  • Secure and automatable process creation
  • Cleanup created processes automatically on termination (e.g. exiting claude code)
  • Common process management features supported, restarting, deleting, checking status or retreving stdout/stderr of processes

Using these features, LLMs start processes like development servers, docker-compose, or test watchers and check their outputs to fix bugs automatically.

Installation

npm i -D procm-mcp

.mcp.json

{
  "mcpServers": {
    "procm-mcp": {
      "command": "node",
      "args": ["./node_modules/procm-mcp/build/index.js"],
      "env": {}
    }
  }
}

Secure process creation

You can permit LLMs to use start-process tool without confirmation, because procm-mcp only allow whitelisted process creations.

LLMs will ask you to use allow-start-process tool to add specific process creation to the whitelist.

Once you allow a process creation, you don't have to confirming it anymore as long as the command and the working directory are the same.

I call it "allow-x pattern", which can balances security and usability in MCP.

Warning: Do not permit LLMs to use allow-start-process without confirmation.That means "Do anything you want to".

Tools

  • allow-start-process Allow specific processes to be created
    • script (required): The script/command to allow
    • args (optional): Array of arguments
    • cwd (optional): Working directory
  • start-process Start a new process with specified script and arguments
    • script (required): The script/command to execute
    • name (optional): A friendly name for the process
    • args (optional): Array of arguments to pass to the script
    • cwd (required): Working directory for the process
    • envs (optional): Environment variables to set for the process
  • delete-process Stop and remove a process by ID.The default signal is SIGTERM, but SIGKILL(force killing) will be sent after 10 seconds unless the process exits.
    • id (required): The process ID
  • restart-process Restart an existing process by ID
    • id (required): The process ID
  • get-process-info Get detailed information about a process
    • id (required): The process ID
  • list-processes List all currently managed processes
    • No parameters required
  • get-process-stdout Retrieve stdout logs from a process
    • id (required): The process ID
    • chunkCount (optional): Number of recent log entries to retrieve (default: 10)
  • get-process-stderr Retrieve stderr logs from a process
    • id (required): The process ID
    • chunkCount (optional): Number of recent log entries to retrieve (default: 10)

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.