neptaco/mcproc
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
start_process
Start a development server or background process.
stop_process
Stop a running process.
restart_process
Restart a process.
list_processes
List all running processes.
get_process_logs
Retrieve process logs.
search_process_logs
Search through process logs with pattern matching.
get_process_status
Get detailed process information.