Procm MCP server
✓ VerifiedEnables AI clients to create, manage, and monitor system processes like development servers and test watchers.
Also known as coder-ka/procm-mcp, procm-mcp
- Stars
- 5
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 0.0.43
- Last commit
- May 31, 2026
- License
- —
What is Procm MCP?
Procm enables AI clients to create, manage, and monitor system processes like development servers and test watchers. It exposes 6 tools, such as allow-start, start, delete.
Summary generated from the project's README
About Procm MCP server
Procm provides a way for AI clients to handle system processes directly on your machine. It allows an LLM to launch and oversee tasks such as development servers, docker-compose commands, or test watchers. Developers can install it via npm and configure it in their mcp.json file using a node command. The server manages the lifecycle of these tasks, including restarting them or deleting them by their ID.
Security is handled through a whitelist system called the allow-x pattern. Instead of granting unrestricted access, you use the allow-start-process tool to authorize specific scripts and working directories. Once a command is whitelisted, the AI can run it without further confirmation. The server also ensures that all created processes are cleaned up automatically when the client session ends, preventing orphaned background tasks from consuming system resources.
What you can do with it
- 1Automated bug fixingAn AI can start a test watcher and read the error logs to identify and fix code issues.
- 2Secure command authorizationYou can permit specific scripts to run without manual confirmation by adding them to a whitelist.
- 3Process monitoring and debuggingA developer can instruct an AI to retrieve recent stdout or stderr logs from a running process.
- 4Lifecycle managementThe AI can stop and remove specific processes using a SIGTERM signal or a forced SIGKILL.
Written from the project's README. Every use case is checked against a quote from it.
How to install Procm MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Procm MCP in Claude Code
$ claude mcp add procm-mcp -- npx -y procm-mcpInstall Procm MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"procm-mcp": {
"command": "npx",
"args": [
"-y",
"procm-mcp"
]
}
}
}Install Procm MCP in VS Code
.vscode/mcp.json
{
"servers": {
"procm-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"procm-mcp"
]
}
}
}Install Procm MCP in VS Code CLI
$ code --add-mcp '{"name":"procm-mcp","type":"stdio","command":"npx","args":["-y","procm-mcp"]}'Install Procm MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"procm-mcp": {
"command": "npx",
"args": [
"-y",
"procm-mcp"
]
}
}
}Install Procm MCP in Codex
$ codex mcp add procm-mcp -- npx -y procm-mcpInstall Procm MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.procm-mcp] command = "npx" args = ["-y", "procm-mcp"]
Install Procm MCP in Gemini CLI
$ gemini mcp add -s user procm-mcp npx -- -y procm-mcpInstall Procm MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"procm-mcp": {
"command": "npx",
"args": [
"-y",
"procm-mcp"
]
}
}
}Procm MCP tools 6
Detected from the READMEallow-startstartdeleterestartget-processlist
| allow-start | — | |
| start | — | |
| delete | — | |
| restart | — | |
| get-process | — | |
| list | — |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablecoder-ka/procm-mcp is public and reachablegithub.com/coder-ka/procm-mcp ↗Pass
- Package names this repository as its sourceprocm-mcp names coder-ka/procm-mcp as sourcenpmjs.com/package/procm-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for procm-mcpnpmjs.com/package/procm-mcp/v/0.0.43#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-05-31github.com/coder-ka/procm-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from procm-mcpPass
- No critical advisory in the package or its dependencies104 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubprocm-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-processAllow specific processes to be createdscript(required): The script/command to allowargs(optional): Array of argumentscwd(optional): Working directory
start-processStart a new process with specified script and argumentsscript(required): The script/command to executename(optional): A friendly name for the processargs(optional): Array of arguments to pass to the scriptcwd(required): Working directory for the processenvs(optional): Environment variables to set for the process
delete-processStop 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-processRestart an existing process by IDid(required): The process ID
get-process-infoGet detailed information about a processid(required): The process ID
list-processesList all currently managed processes- No parameters required
get-process-stdoutRetrieve stdout logs from a processid(required): The process IDchunkCount(optional): Number of recent log entries to retrieve (default: 10)
get-process-stderrRetrieve stderr logs from a processid(required): The process IDchunkCount(optional): Number of recent log entries to retrieve (default: 10)
License
MIT
Procm MCP questions
How do I add Procm MCP to Claude Code?
Run claude mcp add procm-mcp -- npx -y procm-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Procm MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Procm MCP provide?
It exposes 6 tools, including allow-start, start, delete, restart, get-process.
How does the server handle process security?
It uses an 'allow-x pattern' where processes must be added to a whitelist using the allow-start-process tool before they can be executed without confirmation.
What happens to processes when the MCP client terminates?
The server automatically cleans up and terminates any processes it created upon termination.
Can I see the output of a running process?
Yes, you can retrieve both stdout and stderr logs for specific processes.
How are processes stopped?
Processes are stopped using a SIGTERM signal by default, but a SIGKILL is sent if the process does not exit within 10 seconds.