🪟 Windows Operations MCP — SOTA v14.1.0

에이전트 생태계를 위한 네이티브 Windows 제어 평면 및 데이터 수술 도구

windows-operations-mcp는 LLM에게 Windows 네이티브 작업 및 복잡한 데이터 조작을 위한 고충실도 제어 평면을 제공하도록 설계된 전문적인 산업용 MCP 서버입니다. 일반적인 파일 시스템 오버헤드를 우회하여 레지스트리, 사용자 계정, 작업 자동화 및 SOTA 데이터 로직과의 심층적인 통합을 제공합니다.

🚀 주요 기능 (SOTA v14.0)

🛠️ Windows 네이티브 제어

• 레지스트리 관리: 자동 백업, 심층 트리 쿼리 및 값 조작을 지원하는 안전 모드 편집.

• 계정 작업: 로컬 사용자 및 그룹 관리 (목록 보기, 추가, 비밀번호 재설정).

• 자동화 허브: 예약된 작업(schtasks) 오케스트레이션 및 WMI/CIM 시스템 인트로스펙션.

• 권한 (ICACLS): 재귀적 상속 제어를 포함한 세밀한 NTFS ACL 관리.

• 네트워킹 제어: 네이티브 방화벽 오케스트레이션 (netsh) 및 어댑터 진단. [신규]

• 환경 설정: 시스템 전체 브로드캐스팅을 지원하는 영구적 사용자/시스템 환경 변수 관리. [신규]

• 앱 관리: AppX/Store 패키지 관리 및 자동화된 블로트웨어 제거. [신규]

🧬 전문 데이터 수술

• JSON 포트만토: 심층 패치(재귀적 병합), 비정형 텍스트에서 퍼지 JSON 추출 및 표준 준수 유효성 검사.

• 아카이브 로직: ZIP, TAR 및 네이티브 Windows 캐비닛(.cab) 확장을 위한 통합 인터페이스.

• 안전 모드: 파괴적인 작업 전 자동 상태 보존 (예: 레지스트리 내보내기).

🛰️ 에이전트 원격 측정 및 샘플링

• FastMCP 3.2.0+: ctx: Context 원격 측정 완벽 지원.

• LLM-in-the-loop: 자율적인 장애 복구 및 수리 제안을 위한 통합 ctx.sample().

• 산업용 로깅: 고동시성 환경을 위한 구조화된 비동기 로깅.

Related MCP server: Python MCP Custom Server

📦 설치

mcp install windows-operations-mcp

또는 mcp_config.json을 통한 수동 설정:

{
  "mcpServers": {
    "windows-operations": {
      "command": "python",
      "args": ["-m", "windows_operations_mcp"],
      "env": {
        "PYTHONPATH": "C:/path/to/repo/src"
      }
    }
  }
}

🛠️ 도구 레지스트리 참조

📜 윤리적 가이드라인 및 안전

1. 안전 모드 (레지스트리): safe_mode=True(기본값) 설정 시 쓰기/삭제 작업 전에 레지스트리 키를 backups/registry/로 자동 내보냅니다.

2. 상황 인식: 에이전트에게 고영향 작업에 대한 실시간 진행 보고서 및 경고 로그가 제공됩니다.

3. 환원주의 로직: 중복 도구 없음. 간결하고 고성능인 오케스트레이션 계층을 유지하기 위해 표준 파일 시스템 작업은 filesystem-mcp에 위임합니다.

🧪 개발 및 테스트

사전 요구 사항

• Windows 10/11 Pro

• Python 3.10+

• fastmcp 3.2.0

테스트 실행

pytest

저자: Sandra Schipal (오스트리아 빈)
라이선스: MIT

🛡️ 산업 품질 스택

이 프로젝트는 고충실도 에이전트 오케스트레이션을 위한 SOTA 14.1 산업 표준을 준수합니다:

• Python (코어): 린팅 및 포맷팅을 위한 Ruff. 코어 핸들러 내 print 문 무관용 (T201).

• 웹앱 (UI): 밀리초 단위 린팅을 위한 Biome. 엄격한 noConsoleLog 적용.

• 프로토콜 준수: 충돌 방지 JSON-RPC 통신을 보장하기 위한 강화된 stdout/stderr 격리.

• 자동화: 모든 플릿 작업을 위한 Justfile 레시피 (just lint, just fix, just dev).

• 보안: bandit 및 safety를 통한 자동화된 감사.