Skip to main content
Glama

Быстрый старт

# 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)

Tool

Description

system_overview

ЦП, ОЗУ, время работы, версия ОС с рекомендациями по состоянию

top_processes

Основные потребители ЦП/памяти с обнаружением «пожирателей» ресурсов

port_check

Прослушиваемые порты с обнаружением конфликтов для портов разработки

services_status

Состояние служб Windows, мониторинг критических служб

event_log_errors

Недавние ошибки с объяснениями на простом языке

disk_usage

Анализ дискового пространства с предложениями по очистке

startup_programs

Программы автозагрузки с рекомендациями по безопасному отключению

Система и ОС (4)

Tool

Description

windows_license

Статус активации, редакция, тип лицензии

virtual_memory

Конфигурация файла подкачки, объём выделенной памяти, анализ подкачки

time_sync

NTP-сервер, расхождение часов, служба W32Time

system_errors

Категоризированные критические/ошибочные события (диск, драйвер, сеть и т.д.)

Оборудование (6)

Tool

Description

gpu_status

Модель GPU, видеопамять, версия драйвера, загрузка

battery_status

Заряд, здоровье %, количество циклов, оставшееся время

thermal_status

Температуры ЦП/системы, обнаружение перегрева

ram_details

Слоты DIMM, скорость, тип, потенциал апгрейда

bios_info

Версия UEFI/BIOS, Secure Boot, статус TPM

display_info

Мониторы, разрешение, частота обновления, масштабирование

Сеть (9)

Tool

Description

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)

Tool

Description

large_files

Поиск самых больших файлов на диске по размеру

duplicate_files

Поиск одинаковых файлов, занимающих место (хэш MD5)

Производительность и устранение неполадок (4)

Tool

Description

memory_leaks

Обнаружение процессов с растущей памятью, избыточными дескрипторами

crash_dumps

Минидампы BSOD, сбои приложений, частота сбоев

pending_reboots

Проверка всех флагов «требуется перезагрузка»

slow_boot_analysis

Фазы времени загрузки, медленные элементы автозагрузки

Безопасность (7)

Tool

Description

firewall_status

Состояния профилей, количество правил, недавние блокировки

defender_status

Защита в реальном времени, определения, угрозы

open_shares

Общие ресурсы SMB с аудитом разрешений

user_accounts

Локальные учётные записи, аудит администраторов, возраст пароля

bitlocker_status

Статус шифрования дисков по томам

exploit_protection

DEP, ASLR, CFG, HVCI, Credential Guard

privacy_settings

Телеметрия, рекламный идентификатор, геолокация, камера/микрофон

Инструменты разработчика (12)

Tool

Description

dev_environments

Установленные SDK (Node, Python, .NET, Java, Go, Rust)

git_repos

Репозитории с незакоммиченными/неотправленными изменениями

npm_global_packages

Глобальные пакеты, обнаружение устаревших

vscode_extensions

Расширения с пометкой тяжёлых/устаревших

ssh_keys

Инвентаризация ключей, аудит парольных фраз, статус агента

wsl_disk_usage

Размеры VHD WSL, рекомендации по сжатию

localhost_servers

Сканирование портов разработки (что запущено локально)

dotnet_sdks

Версии .NET SDK/runtime, проверка global.json

docker_status

Контейнеры, образы, статус демона

wsl_status

Дистрибутивы, версии, состояние запуска

installed_software

Программы с обнаружением bloatware

environment_variables

Анализ PATH, ключевые переменные окружения

Обслуживание (8)

Tool

Description

windows_updates

Ожидающие обновления, история, состояние автообновления

scheduled_tasks

Несистемные задачи, обнаружение сбойных задач

windows_features

Дополнительные компоненты (Hyper-V, WSL, IIS, Sandbox)

startup_impact

Элементы автозагрузки с оценкой влияния на загрузку

driver_issues

Отсутствующие/сбойные/устаревшие драйверы

windows_search

Статус индексатора, размер индекса

certificate_store

Истекающие/истёкшие SSL-сертификаты

system_restore_points

Точки восстановления, возраст, триггеры создания

Мониторинг (2)

Tool

Description

uptime_history

События загрузки/выключения, оценка стабильности

performance_baseline

Снимок и сравнение системных метрик с течением времени

Рабочий процесс и продуктивность (3)

Tool

Description

clipboard_history

Текущий буфер обмена, записи истории

recent_files

Недавно открывавшиеся файлы с поиском

power_plan

Активный план, обнаружение троттлинга

Автоматизация (2)

Tool

Description

powershell_profile

Время загрузки профиля, аудит импорта модулей

startup_services

Службы автозапуска, обнаружение сбойных

Дополнительная диагностика (5)

Tool

Description

font_list

Установленные шрифты с поиском

usb_devices

Подключённые USB-периферия и диски

disk_health

Данные S.M.A.R.T., уровень износа, прогноз отказа диска

screen_recording

Обнаружение активного ПО записи/демонстрации экрана

task_manager_summary

Комплексный снимок ЦП/ОЗУ/Диск/Сеть/GPU

Интеграции (2)

Tool

Description

ollama_models

Инвентаризация локальных моделей Ollama

system_report

Генерация полного отчёта о состоянии в Markdown

Действия записи (12, требуют --allow-actions)

Tool

Description

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

Ключевые проектные решения:

  • Безопасное для антивируса выполнение: скрипты PowerShell записываются во временные файлы .ps1 и запускаются с флагом -File (не -EncodedCommand, который вызывает эвристику антивируса)

  • Единый реестр: одно определение инструмента, используемое как MCP-, так и HTTP-транспортом

  • Корректная деградация: инструменты определяют, когда функции недоступны (Docker не установлен, нет WiFi-адаптера и т.д.), и возвращают полезные сообщения вместо ошибок

  • Практические рекомендации: каждый инструмент возвращает не только данные, но и что с ними делать

  • Ограниченные действия записи: опасные операции требуют явного флага --allow-actions

Флаги CLI

Флаг

Описание

--serve

Запустить HTTP-сервер вместо MCP stdio

--port=N

Порт HTTP-сервера (по умолчанию: 7890)

--allow-actions

Включить инструменты записи действий

--version, -v

Вывести версию и количество инструментов

--list-tools

Вывести все инструменты с описаниями

Требования

  • Windows 10/11

  • Node.js 20+

  • PowerShell 5.1+ (поставляется с Windows)

Лицензия

MIT

Related MCP Connectors

Related MCP Servers

  • 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
  • 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
  • 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