Linux용 Claude Desktop을 위한 읽기 전용 systemd 검사 도구입니다. Claude가 가장 흔한 Linux 운영 관련 질문인 *"왜 이 서비스가 고장 났나요?"*에 대해 systemctl 및 journalctl 출력을 일일이 복사해서 붙여넣을 필요 없이 답변할 수 있게 해줍니다.
7가지 도구를 통해 유닛 목록 확인, 유닛별 상태, 저널 테일링(tailing), 실패한 유닛 탐색, 유닛 속성 검사, 원본 유닛 파일 표시(드롭인 오버라이드 포함), 대기 중인 작업 검사를 수행할 수 있습니다.
v0.1 버전은 엄격한 읽기 전용입니다. restart, enable, disable, daemon-reload 기능은 없습니다. 프로덕션 호스트나 공유 시스템에서도 안전하게 활성화할 수 있습니다. 파괴적인 제어 권한이 필요하다면 claude-terminal-mcp를 통해 해당 명령어를 수동으로 실행하세요.
systemd가 설치된 Linux (최신 Ubuntu/Debian/Fedora/Arch 등).
PATH에 systemctl 및 journalctl이 포함되어 있어야 함 (systemd와 함께 기본 제공).
확인하려는 유닛에 대한 저널 읽기 권한. 기본적으로 시스템 전체 저널에 접근하려면 systemd-journal 또는 adm 그룹에 속해야 합니다. 사용자 범위의 저널은 항상 소유자가 읽을 수 있습니다.
Related MCP server: systemd-mcp
Releases 페이지에서 최신 Systemd.mcpb를 다운로드합니다.
설정 → 확장 프로그램 → 확장 프로그램 개발자 → 확장 프로그램 설치 → .mcpb 파일을 선택합니다.
활성화합니다.
도구 | 답변 내용 |
| 실행 중인 항목은 무엇인가? 로드된 항목은 무엇인가? 유형/상태별 필터링 가능. |
| 현재 고장 난 항목이 있는가? |
| 특정 유닛의 상세 상태: 활성/하위 상태, 활성화 상태, 메인 PID, 재시작 횟수, 최근 저널 라인, 조각 경로, 드롭인 오버라이드 경로. |
| 전체 속성 덤프 (환경 변수, ExecStart, 재시작 정책, 의존성 등 100개 이상의 속성). |
| 원본 유닛 파일 텍스트 및 드롭인 오버라이드 — |
| 유닛/시간/우선순위 필터를 선택하여 최근 로그 항목 확인. |
| 현재 대기 중이거나 실행 중인 systemd 작업 (드묾; 멈춘 활성화 작업 확인에 유용). |
모든 도구는 --user 유닛을 검사하기 위해 scope: "user"를 지원합니다. 기본 범위는 system입니다.
"현재 실패 상태인 항목이 있나요?" →
failed_units"왜
ollama.service가 GPU를 사용하지 않나요? 드롭인 오버라이드와 마지막 50줄의 로그를 보여주세요." →unit_cat ollama실행 후tail_journal unit=ollama lines=50"지난 10분 동안 저널에 기록된 오류 이상의 메시지는 무엇인가요?" →
tail_journal priority=3 since="10 minutes ago""
nginx가 부팅 시 활성화되어 있나요? 그리고 마지막 부팅 이후 몇 번 재시작되었나요?" →unit_status nginx
이 확장 프로그램은 전적으로 로컬 머신에서 실행되며 systemctl 및 journalctl만 호출합니다. 데이터가 머신 외부로 유출되지 않습니다. 네트워크 I/O가 없습니다. 읽기 전용이므로 수정, 재시작, 활성화, 비활성화, 다시 로드 등을 수행할 수 없습니다.
Claude가 볼 수 있는 정보는 다음과 같습니다:
쿼리하는 모든 시스템 또는 사용자 유닛의 이름, 설명 및 메타데이터 (list_units 호출 시 로드된 모든 유닛).
유닛 파일 및 드롭인 오버라이드의 전체 내용 (unit_cat) — 여기에 설정한 경우 Environment= 라인에 비밀 정보가 포함될 수 있습니다. 이 확장 프로그램을 활성화할 계획이라면 유닛 파일에 자격 증명을 저장하지 마십시오.
쿼리된 유닛의 최근 저널 항목 — 서비스가 기록하는 모든 메시지를 포함하며, 여기에는 개인 식별 정보, IP 주소, 요청 경로 또는 스택 트레이스가 포함될 수 있습니다.
서비스의 프로세스 ID, 재시작 횟수 및 런타임 속성.
유닛 파일이나 저널에 민감한 데이터가 포함되어 있고 LLM 엔드포인트를 신뢰할 수 없다면 이 확장 프로그램을 활성화하지 마십시오.
restart_unit / enable_unit / disable_unit 세트는 다음 이유로 v0.1에서 의도적으로 제외되었습니다:
시스템 범위 유닛의 경우 루트 권한이 필요하므로, Claude Desktop을 루트로 실행하거나(위험함) sudo 규칙을 구성해야 합니다(확장 프로그램별 번거로움).
이 확장 프로그램이 실제로 제공하는 워크플로우에서는 거의 필요하지 않습니다. *"왜 X가 고장 났는가"*가 95%의 사례입니다.
서비스를 재시작해야 하는 경우, 기존 claude-terminal-mcp를 사용하면 다른 곳에서 사용하는 것과 동일한 sudo 메커니즘으로 run_command sudo systemctl restart <unit>을 실행할 수 있으며, 시스템 프롬프트에서 확인 단계도 거칩니다.
이 확장 프로그램을 읽기 전용으로 유지함으로써 신뢰 문제 없이 프로덕션 호스트, 공유 워크스테이션 또는 고객 머신에서 활성화할 수 있습니다. v0.2에서 재검토될 수 있습니다.
"systemctl is not installed" — 이 서버는 Linux 전용입니다. macOS와 Windows는 systemd를 실행하지 않습니다.
"Permission denied" (저널 읽기 시) — systemd-journal 또는 adm 그룹에 자신을 추가하세요: sudo usermod -aG systemd-journal $USER 실행 후 로그아웃했다가 다시 로그인하세요. 또는 scope: "user"를 사용하여 자신의 사용자 범위 저널만 읽을 수 있습니다(그룹 권한 불필요).
tail_journal 결과가 비어 있음 — 일부 배포판은 저널 속도가 제한되거나 휘발성입니다. /etc/systemd/journald.conf에서 Storage=를 확인하세요. volatile로 설정되어 있으면 재부팅 시 저널이 삭제됩니다.
약 400줄의 단일 Node.js 스크립트로, npm 의존성이 없습니다. .mcpb를 다시 빌드하려면:
cd bundle-source
zip -j ../Systemd.mcpb manifest.json package.json server.js README.md LICENSE icon.png glama.jsonMIT. LICENSE를 참조하세요.
claude-terminal-mcp — 셸 + 파일 시스템 + 백그라운드 작업 (파괴적인 systemctl 작업에 사용).
claude-sessions-mcp — 장기 실행 작업을 위한 tmux 세션 관리.
claude-rocm-mcp — AMD GPU 모니터링; "GPU가 정상인가?"와 "GPU 서비스가 정상인가?"를 함께 확인할 때 유용.
claude-linux-mcp — X11 데스크톱 제어.
claude-ollama-mcp — 로컬 Ollama HTTP-API 클라이언트.
This server cannot be deployed
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Discover Frontier inference capabilities and read sanitized usage through read-only tools.
Search verified Claude Code plugins and skills; fetch portable SKILL.md sources. Read-only.
