mcproc

neptaco/mcproc

3.3

If you are the rightful owner of mcproc and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

mcproc is a Model Context Protocol (MCP) server designed for efficient background process management in AI agent environments.

mcproc bridges the gap between AI agent development and traditional command-line workflows. It enables AI agents to manage long-running development processes such as development servers and build watchers, while providing developers with full CLI access to monitor and control these processes. This tool addresses the limitations of stateless AI agent-launched processes by offering unified control, context preservation, and developer-friendly features. With mcproc, all processes are centrally managed, logs are captured and stored for debugging, and developers retain full access to their development environment. The tool is project-aware, automatically grouping processes by project context, and offers real-time monitoring capabilities. It adheres to the XDG Base Directory specification for proper file organization, ensuring a clean and organized setup.

Features

  • Unified Process Management: Start and manage background processes from AI agents via MCP, then monitor them from your terminal.
  • Cross-Environment Visibility: Processes started by AI agents are fully accessible via CLI and other agents, and vice versa.
  • Intelligent Log Management: Capture, persist, and search process logs with powerful regex patterns.
  • Project-Aware: Automatically groups processes by project context.
  • Real-time Monitoring: Follow logs in real-time from CLI while AI agents manage the processes.

Usages

usage with Claude Code

bash
# Register mcproc as an MCP server
claude mcp add mcproc mcproc mcp serve

usage with Other MCP Clients

{
  "mcpServers": {
    "mcproc": {
      "command": "mcproc",
      "args": ["mcp", "serve"]
    }
  }
}

Tools

  1. start_process

    Start a development server or background process.

  2. stop_process

    Stop a running process.

  3. restart_process

    Restart a process.

  4. list_processes

    List all running processes.

  5. get_process_logs

    Retrieve process logs.

  6. search_process_logs

    Search through process logs with pattern matching.

  7. get_process_status

    Get detailed process information.