# Procm

Procm lets an agent start and monitor project processes, such as a development server or a test watcher.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: coder-ka
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/coder-ka/procm-mcp
- Updated: 2026-05-31
- HTML: https://affpapa.org/en/nevibecode/mcp/procm

## What it does

An agent can launch a process in a chosen working directory, inspect its status, and read its stdout or stderr. It can also restart or stop a process; processes it created are cleaned up when the MCP server terminates. This helps when an agent needs to inspect server or test output while tracking down a failure.

Process creation uses an allowlist. The agent can request permission for a command with `allow-start-process`; approval applies when the command and working directory match. Do not allow this tool to run without confirmation, since that would let the agent add arbitrary commands. To connect Procm to Claude Code, run `claude mcp add procm -- npx -y procm-mcp`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add procm-mcp -- npx -y procm-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add procm -- npx -y procm-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "procm": {
            "command": "npx",
            "args": [
                "-y",
                "procm-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "procm": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "procm-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add procm npx -y procm-mcp
```

## When to use it
- start a development server from the project
- check whether a process is running
- read a process's stdout or stderr
- restart or stop a process by ID
- allow a command for a specific working directory

## Example prompts
- Start the development server in this project and inspect its output.
- Show stderr for process ID `123`.
- Restart process `123` and check its status.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md