Procm

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

AI & MLJavaScriptv0.0.43

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y procm-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-coder-ka-procm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "procm-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

procm-mcpnpm

Compatible MCP Clients

Procm works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More