mcproc MCP server
2026년 10월 5일 커밋통합 CLI 및 MCP 인터페이스를 통해 AI agent가 개발 서버와 같은 장기 실행 백그라운드 프로세스를 관리, 모니터링 및 디버깅할 수 있도록 지원합니다.
다른 이름 neptaco/mcproc
- 스타
- 10
- Tools
- 7
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 5일
- 라이선스
- MIT
mcproc MCP란?
mcproc은(는) MCP server입니다. 통합 CLI 및 MCP 인터페이스를 통해 AI agent가 개발 서버와 같은 장기 실행 백그라운드 프로세스를 관리, 모니터링 및 디버깅할 수 있도록 지원합니다. 7개 도구를 제공합니다. 예: start_process, stop_process, restart_process.
프로젝트 README에서 생성된 요약
mcproc MCP server 정보
mcproc는 AI agent가 개발 서버나 빌드 워처와 같은 장기 실행 백그라운드 작업을 처리할 수 있는 방법을 제공합니다. 통합 제어 시스템을 제공함으로써 자동화된 agent와 수동 터미널 워크플로 사이의 간극을 메워줍니다. 개발자는 명령줄을 사용하여 AI agent가 시작한 프로세스를 모니터링하거나 제어할 수 있으므로, 자신의 개발 환경에서 소외되는 일이 없습니다.
이 시스템은 경량 데몬, CLI, 그리고 MCP server를 통해 작동합니다. 사용하려면 Claude Code와 같은 MCP client에 server를 등록하거나 설정 파일에 추가해야 합니다. nvm, mise, asdf, rbenv와 같은 버전 관리자를 지원하여 특정 툴체인 내에서 명령어를 실행할 수 있습니다.
agent가 사용할 수 있는 주요 도구에는 start_process, stop_process, search_process_logs가 포함됩니다. server는 정규식 패턴과 시간 기반 필터링을 사용하여 로그를 관리하며, 파일 구성 시 XDG 사양을 따릅니다. 또한 프로젝트별 그룹화가 가능하며, 특정 로그 패턴이 나타날 때까지 대기하여 프로세스 준비 완료를 확인할 수 있습니다.
활용 사례
- 1실시간 프로세스 모니터링개발자가 AI assistant가 시작한 프로세스의 실시간 출력을 확인할 수 있습니다.
- 2프로젝트 일괄 정리단일 명령어를 사용하여 특정 프로젝트와 관련된 모든 실행 프로세스를 중지할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
mcproc MCP 도구 7
README에서 감지됨start_processstop_processrestart_processlist_processesget_process_logssearch_process_logsget_process_status
| start_process | — | |
| stop_process | — | |
| restart_process | — | |
| list_processes | — | |
| get_process_logs | — | |
| search_process_logs | — | |
| get_process_status | — |
구성
RUST_LOG
| 이름 | 설명 | 유형 |
|---|---|---|
| RUST_LOG | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능neptaco/mcproc is public and reachablegithub.com/neptaco/mcproc ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-05github.com/neptaco/mcproc ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음7 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기mcproc
A Model Context Protocol (MCP) server for comfortable background process management on AI agents.
Overview
mcproc bridges the gap between AI agent development and traditional command-line workflows. It enables AI agents to manage long-running development processes (like dev servers, build watchers, etc.) while providing developers with full CLI access to monitor and control these same processes.
Why mcproc?
Simple AI agent-launched processes are stateless and can't manage long-running processes effectively. mcproc solves this by:
- Unified Control: No more confusion about which agent or terminal is running what - all processes are centrally managed
- Context Preservation: Logs are captured and stored, allowing AI agents to debug issues while reviewing logs from earlier
- Developer-Friendly: Full CLI access means you're never locked out of your own development environment
Key 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
- 🛡️ XDG Compliant: Follows XDG Base Directory specification for proper file organization
- ⚡ Wait-for-Log: Start processes and wait for specific log patterns to ensure readiness
- 🔍 Advanced Search: Time-based filtering, context lines, and regex support for log analysis
- 🧰 Toolchain Support: Execute commands through version managers (mise, asdf, nvm, rbenv, etc.)
- 🧹 Clean Command: Stop all processes in a project with a single command
- 🌲 Process Groups: Automatic cleanup of child processes when stopping parent processes
Installation
Using Homebrew (macOS and Linux)
# Add the tap
brew tap neptaco/tap
# Install mcproc
brew install mcproc
Build from source
Prerequisites
- Rust toolchain (rustc, cargo)
- protobuf compiler:
- macOS:
brew install protobuf - Linux:
apt-get install protobuf-compiler
- macOS:
git clone https://github.com/neptaco/mcproc.git
cd mcproc
cargo build --release
# Install to PATH (optional)
cargo install --path mcproc
Usage
Setup as MCP Server
After installing mcproc, you need to register it as an MCP server with your AI assistant.
For Claude Code
# Register mcproc as an MCP server
claude mcp add mcproc mcproc mcp serve
For Other MCP Clients
Configure your MCP client by adding mcproc to your configuration:
{
"mcpServers": {
"mcproc": {
"command": "mcproc",
"args": ["mcp", "serve"]
}
}
}
Available MCP Tools
Once registered, AI agents can use these tools:
start_process: Start a development server or background processstop_process: Stop a running processrestart_process: Restart a processlist_processes: List all running processesget_process_logs: Retrieve process logssearch_process_logs: Search through process logs with pattern matchingget_process_status: Get detailed process information
For Developers (CLI)
While AI agents manage processes in the background, you can monitor and control them:
Recommended command: mcproc logs -f
CLI Commands
| Command | Description | Flags | Example |
|---|---|---|---|
🗒️ ps |
List all running processes | -s, --status <STATUS> Filter by status |
mcproc ps --status running |
🚀 start **<NAME>** |
Start a new process | -c, --cmd <CMD> Command to run-d, --cwd <DIR> Working directory-e, --env <KEY=VAL> Environment variables-p, --project <NAME> Project name--wait-for-log <PATTERN> Wait for log pattern--wait-timeout <SECS> Wait timeout--toolchain <TOOL> Version manager to use |
mcproc start web -c "npm run dev" -d ./app |
🛑 stop **<NAME>** |
Stop a running process | -p, --project <NAME> Project name-f, --force Force kill (SIGKILL) |
mcproc stop web -p myapp |
🔄 restart **<NAME>** |
Restart a process | -p, --project <NAME> Project name |
mcproc restart web |
📜 logs **<NAME>** |
View process logs | -p, --project <NAME> Project name-f, --follow Follow log output-t, --tail <NUM> Number of lines to show |
mcproc logs web -f -t 100 |
🔍 grep **<NAME>** **<PATTERN>** |
Search logs with regex | -p, --project <NAME> Project name-C, --context <NUM> Context lines-B, --before <NUM> Lines before match-A, --after <NUM> Lines after match--since <TIME> Search since time--until <TIME> Search until time--last <DURATION> Search last duration |
mcproc grep web "error" -C 3 |
🧹 clean |
Stop all processes in project | -p, --project <NAME> Project name-f, --force Force kill |
mcproc clean -p myapp |
🎛️ daemon start |
Start mcproc daemon | None | mcproc daemon start |
🎛️ daemon stop |
Stop mcproc daemon | None | mcproc daemon stop |
🎛️ daemon status |
Check daemon status | None | mcproc daemon status |
🔌 mcp serve |
Run as MCP server | None | mcproc mcp serve |
ℹ️ --version |
Show version info | None | mcproc --version |
❓ --help |
Show help message | None | mcproc --help |
Examples
# Start the daemon (if not already running)
mcproc daemon start
# View all processes (including those started by AI agents)
mcproc ps
# Follow logs in real-time
mcproc logs frontend -f
# Multi-process log streaming per project
mcproc logs -f
# Search through logs
mcproc grep backend "error" -C 5
# Stop a process
mcproc stop frontend
Example Workflow
-
AI agent starts your development server:
Agent: "I'll start the frontend dev server for you" → Uses MCP tool: start_process(name: "frontend", cmd: "npm run dev", wait_for_log: "Server running") -
You monitor it from terminal:
mcproc logs -f # See real-time logs as the server runs -
AI agent detects an error and searches logs:
Agent: "Let me check what's causing that error" → Uses MCP tool: search_process_logs(name: "frontend", pattern: "ERROR|WARN", last: "5m") -
You can see the same information:
mcproc grep frontend "ERROR|WARN" -C 3 --last 5m
Advanced Examples
# Start a process with environment variables
mcproc start api --cmd "python app.py" --env PORT=8000 --env DEBUG=true
# Wait for a specific log pattern before considering the process ready
mcproc start web --cmd "npm run dev" --wait-for-log "Server running on" --wait-timeout 60
# Search logs with time filters
mcproc grep api "database.*connection" --since "14:30" --until "15:00"
# View logs from multiple processes in the same project
mcproc ps
mcproc logs web --project myapp -t 100
# Use version managers for Node.js projects
mcproc start web --cmd "npm run dev" --toolchain nvm
mcproc start api --cmd "yarn start" --toolchain mise
# Clean up all processes in a project
mcproc clean --project myapp
# Force stop all processes in current project
mcproc clean --force
Architecture
mcproc consists of three main components:
- mcproc daemon: A lightweight daemon that manages processes and handles log persistence
- mcproc CLI: Command-line interface for developers to interact with the daemon
- MCP Server: Exposes process management capabilities to AI agents via the Model Context Protocol
File Locations (XDG Compliant)
- Config:
$XDG_CONFIG_HOME/mcproc/config.toml(defaults to~/.config/mcproc/) - Logs:
$XDG_STATE_HOME/mcproc/log/(defaults to~/.local/state/mcproc/log/) - Runtime:
$XDG_RUNTIME_DIR/mcproc/(defaults to/tmp/mcproc-$UID/)
Development
Building from Source
# Clone the repository
git clone https://github.com/neptaco/mcproc.git
cd mcproc
# Build all components
cargo build --release
# Run tests
cargo test
# Run with verbose logging
RUST_LOG=mcproc=debug cargo run -- daemon start
Project Structure
mcproc/
├── mcproc/ # CLI and daemon implementation
├── mcp-rs/ # Reusable MCP server library
├── proto/ # Protocol buffer definitions
└── docs/ # Architecture and design documentation
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License
Copyright (c) 2025 Atsuhito Machida (neptaco)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
mcproc MCP 질문
mcproc MCP는 어떤 도구를 제공하나요?
7개 도구를 제공합니다. 예: start_process, stop_process, restart_process, list_processes, get_process_logs.
Claude Code에서 mcproc를 어떻게 사용하나요?
claude mcp add mcproc mcproc mcp serve 명령어를 실행하여 MCP server로 등록할 수 있습니다.
AI agent가 시작한 프로세스를 모니터링할 수 있나요?
네, AI agent가 시작한 프로세스는 CLI를 통해 완전히 접근할 수 있으며 실시간으로 로그를 확인할 수 있습니다.
mcproc는 버전 관리자를 지원하나요?
네, mise, asdf, nvm, rbenv와 같은 다양한 버전 관리자를 통한 명령어 실행을 지원합니다.