Skip to main content
Glama
deenesjakoruzh
reprodev

winfolio

by reprodev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

빠른 시작

# Install dependencies
npm install

# Build
npm run build

# Run in MCP mode (Claude, Kiro, Cursor)
npm start

# Run with write actions enabled
npm run start:actions

# Run as HTTP server for local LLMs
npm run serve

# Check version and tool count
node dist/index.js --version

# List all available tools
node dist/index.js --list-tools

Related MCP server: AETHER_01

MCP 구성

MCP 클라이언트 구성(Claude Desktop, Kiro, Cursor)에 추가하세요:

{
  "mcpServers": {
    "winfolio": {
      "command": "node",
      "args": ["C:/path/to/winfolio-mcp/dist/index.js"]
    }
  }
}

액션 활성화 시:

{
  "mcpServers": {
    "winfolio": {
      "command": "node",
      "args": ["C:/path/to/winfolio-mcp/dist/index.js", "--allow-actions"]
    }
  }
}

HTTP 모드(OpenAI 호환)

npm run serve
# Server starts on http://localhost:7890

# Custom port
node dist/index.js --serve --port=8080

엔드포인트:

  • GET / — 서버 정보 및 도구 목록

  • GET /v1/tools — OpenAI 함수 호출 형식의 도구 목록

  • POST /v1/tools/:name — 도구 직접 호출

  • POST /v1/chat/completions — 자동 도구 라우팅이 포함된 OpenAI 호환 채팅

도구(총 85개)

핵심 진단 (7)

도구

설명

system_overview

CPU, RAM, 가동 시간, OS 버전 및 상태 권장 사항

top_processes

리소스 과다 사용 감지가 포함된 상위 CPU/메모리 소비 프로세스

port_check

개발 포트 충돌 감지가 포함된 수신 대기 포트

services_status

Windows 서비스 상태, 중요 서비스 모니터링

event_log_errors

평이한 영어 설명이 포함된 최근 오류

disk_usage

정리 제안이 포함된 드라이브 공간 분석

startup_programs

비활성화 권장 사항이 포함된 부팅 프로그램

시스템 및 OS (4)

도구

설명

windows_license

정품 인증 상태, 에디션, 라이선스 유형

virtual_memory

페이지 파일 구성, 커밋 사용량, 스왑 분석

time_sync

NTP 서버, 시계 오차, W32Time 서비스

system_errors

분류된 중요/오류 이벤트(디스크, 드라이버, 네트워크 등)

하드웨어 (6)

도구

설명

gpu_status

GPU 모델, VRAM, 드라이버 버전, 사용률

battery_status

충전량, 상태 %, 사이클 수, 남은 시간

thermal_status

CPU/시스템 온도, 과열 감지

ram_details

DIMM 슬롯, 속도, 유형, 업그레이드 가능성

bios_info

UEFI/BIOS 버전, Secure Boot, TPM 상태

display_info

모니터, 해상도, 주사율, 배율

네트워킹 (9)

도구

설명

network_info

어댑터, IP, DNS, 게이트웨이, 공인 IP

wifi_networks

표시되는 네트워크, 신호 강도, 저장된 프로필

active_connections

프로세스별로 그룹화된 TCP 연결 (netstat)

hosts_file

의심스러운 리디렉션 감지가 포함된 Hosts 항목

vpn_status

연결된 VPN, 타사 어댑터 감지

proxy_settings

시스템 프록시, WPAD, 환경 변수 프록시

network_speed

어댑터 링크 속도, 처리량 통계

bluetooth_devices

페어링된 장치, 배터리 잔량, 연결 상태

audio_devices

재생/녹음 장치, 상태

저장소 및 정리 (2)

도구

설명

large_files

디스크에서 가장 큰 파일을 크기별로 찾기

duplicate_files

공간을 낭비하는 동일한 파일 찾기 (MD5 해시)

성능 및 문제 해결 (4)

도구

설명

memory_leaks

메모리가 계속 증가하거나 핸들이 과다한 프로세스 감지

crash_dumps

BSOD 미니덤프, 앱 충돌, 충돌 빈도

pending_reboots

재부팅 필요 플래그 전체 확인

slow_boot_analysis

부팅 시간 단계, 느린 시작 항목

보안 (7)

도구

설명

firewall_status

프로필 상태, 규칙 수, 최근 차단

defender_status

실시간 보호, 정의, 위협

open_shares

권한 감사가 포함된 SMB 공유

user_accounts

로컬 계정, 관리자 감사, 암호 사용 기간

bitlocker_status

볼륨별 드라이브 암호화 상태

exploit_protection

DEP, ASLR, CFG, HVCI, Credential Guard

privacy_settings

원격 분석, 광고 ID, 위치, 카메라/마이크

개발자 도구 (12)

도구

설명

dev_environments

설치된 SDK (Node, Python, .NET, Java, Go, Rust)

git_repos

커밋/푸시되지 않은 변경 사항이 있는 저장소

npm_global_packages

전역 패키지, 사용 중단 감지

vscode_extensions

과부하/사용 중단 플래그가 있는 확장 프로그램

ssh_keys

키 인벤토리, 암호 문구 감사, 에이전트 상태

wsl_disk_usage

WSL VHD 크기, 압축 권장 사항

localhost_servers

개발 포트 스캔 (로컬에서 실행 중인 항목)

dotnet_sdks

.NET SDK/런타임 버전, global.json 검증

docker_status

컨테이너, 이미지, 데몬 상태

wsl_status

배포판, 버전, 실행 상태

installed_software

블로트웨어 감지가 포함된 프로그램

environment_variables

PATH 분석, 주요 환경 변수

유지보수 (8)

도구

설명

windows_updates

대기 중인 업데이트, 기록, 자동 업데이트 상태

scheduled_tasks

비시스템 작업, 실패한 작업 감지

windows_features

선택적 기능 (Hyper-V, WSL, IIS, Sandbox)

startup_impact

부팅 영향 등급이 있는 시작 항목

driver_issues

누락/실패/오래된 드라이버

windows_search

인덱서 상태, 인덱스 크기

certificate_store

만료 예정/만료된 SSL 인증서

system_restore_points

복원 지점, 기간, 생성 트리거

모니터링 (2)

도구

설명

uptime_history

부팅/종료 이벤트, 안정성 점수

performance_baseline

시간 경과에 따른 시스템 메트릭 스냅샷 및 비교

워크플로우 및 생산성 (3)

도구

설명

clipboard_history

현재 클립보드, 기록 항목

recent_files

검색 기능이 있는 최근 액세스 파일

power_plan

활성 플랜, 스로틀링 감지

자동화 (2)

도구

설명

powershell_profile

프로필 로드 시간, 모듈 가져오기 감사

startup_services

자동 시작 서비스, 실패 감지

추가 진단 (5)

도구

설명

font_list

검색 기능이 있는 설치된 글꼴

usb_devices

연결된 USB 주변 기기 및 드라이브

disk_health

S.M.A.R.T. 데이터, 마모 수준, 드라이브 고장 예측

screen_recording

활성 녹화/공유 소프트웨어 감지

task_manager_summary

CPU/RAM/디스크/네트워크/GPU 올인원 스냅샷

통합 (2)

도구

설명

ollama_models

로컬 Ollama 모델 인벤토리

system_report

전체 Markdown 상태 보고서 생성

쓰기 액션 (12개, --allow-actions 필요)

도구

설명

kill_process

PID 또는 이름으로 프로세스 종료

restart_service

Windows 서비스 다시 시작/시작/중지

free_port

포트를 점유 중인 프로세스 종료

clear_temp_files

공간 확보를 위해 임시 파일 삭제

flush_dns

DNS 확인자 캐시 지우기

empty_recycle_bin

휴지통 내용 영구 삭제

toggle_dark_mode

Windows 다크/라이트 테마 전환

restart_computer

시스템 다시 시작 예약

disable_startup_item

시작 프로그램 비활성화

create_restore_point

시스템 복원 지점 생성

set_power_plan

전원 플랜 전환 (균형/고성능 등)

toast_notify

기본 Windows 알림 전송

아키텍처

src/
  index.ts              — Entry point, CLI flags, MCP/HTTP transport selection
  powershell.ts         — AV-safe PowerShell executor (temp .ps1 files)
  http-server.ts        — Hono-based OpenAI-compatible HTTP server
  tools/
    registry.ts         — Unified tool registry (both transports consume this)
    *.ts                — Individual tool implementations

주요 설계 결정 사항:

  • AV 안전 실행: PowerShell 스크립트를 임시 .ps1 파일로 작성하고 -File 플래그로 실행합니다 (-EncodedCommand는 바이러스 백신 휴리스틱을 트리거함)

  • 통합 레지스트리: MCP와 HTTP 전송 모두에서 사용되는 단일 도구 정의

  • 우아한 저하: 도구는 기능을 사용할 수 없을 때(Docker 미설치, WiFi 어댑터 없음 등) 오류 대신 유용한 메시지를 반환합니다

  • 실행 가능한 권장 사항: 모든 도구는 데이터뿐만 아니라 무엇을 해야 하는지도 반환합니다

  • 게이트 처리된 쓰기 액션: 위험한 작업은 명시적인 --allow-actions 플래그가 필요합니다

CLI 플래그

플래그

설명

--serve

MCP stdio 대신 HTTP 서버 시작

--port=N

HTTP 서버 포트 (기본값: 7890)

--allow-actions

쓰기 작업 도구 활성화

--version, -v

버전 및 도구 수 출력

--list-tools

설명과 함께 모든 도구 출력

요구 사항

  • Windows 10/11

  • Node.js 20+

  • PowerShell 5.1+ (Windows에 포함됨)

라이선스

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • windows-admin-mcp

    devladpopov
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants to manage, monitor, and diagnose Windows systems through 42 tools across 8 modules, including services, event viewer, task scheduler, processes, network, diagnostics, observability, and safety features.
    19 npm
    9
    MIT

  • AETHER_01

    Githubredminote105g
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to perform extensive Windows system administration, file operations, process management, network configuration, registry editing, GUI automation, and more through a comprehensive set of MCP tools.
    1
    MIT

  • rvn

    valrinx
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI clients to securely control and interact with a local Windows machine through 218 configurable tools for files, Git, processes, Windows UI, browser automation, WSL, Office, recovery, skills, and child MCP servers.
    7 npm
    MIT