winfolio
Быстрый старт
# 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-toolsRelated 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— Инструменты в формате вызова функций OpenAIPOST /v1/tools/:name— Вызов инструмента напрямуюPOST /v1/chat/completions— OpenAI-совместимый чат с автоматической маршрутизацией инструментов
Инструменты (всего 85)
Основная диагностика (7)
Tool | Description |
| ЦП, ОЗУ, время работы, версия ОС с рекомендациями по состоянию |
| Основные потребители ЦП/памяти с обнаружением «пожирателей» ресурсов |
| Прослушиваемые порты с обнаружением конфликтов для портов разработки |
| Состояние служб Windows, мониторинг критических служб |
| Недавние ошибки с объяснениями на простом языке |
| Анализ дискового пространства с предложениями по очистке |
| Программы автозагрузки с рекомендациями по безопасному отключению |
Система и ОС (4)
Tool | Description |
| Статус активации, редакция, тип лицензии |
| Конфигурация файла подкачки, объём выделенной памяти, анализ подкачки |
| NTP-сервер, расхождение часов, служба W32Time |
| Категоризированные критические/ошибочные события (диск, драйвер, сеть и т.д.) |
Оборудование (6)
Tool | Description |
| Модель GPU, видеопамять, версия драйвера, загрузка |
| Заряд, здоровье %, количество циклов, оставшееся время |
| Температуры ЦП/системы, обнаружение перегрева |
| Слоты DIMM, скорость, тип, потенциал апгрейда |
| Версия UEFI/BIOS, Secure Boot, статус TPM |
| Мониторы, разрешение, частота обновления, масштабирование |
Сеть (9)
Tool | Description |
| Адаптеры, IP, DNS, шлюз, публичный IP |
| Видимые сети, уровень сигнала, сохранённые профили |
| TCP-соединения, сгруппированные по процессам (netstat) |
| Записи hosts с обнаружением подозрительных перенаправлений |
| Подключённые VPN, обнаружение сторонних адаптеров |
| Системный прокси, WPAD, прокси из переменных окружения |
| Скорости соединения адаптеров, статистика пропускной способности |
| Сопряжённые устройства, уровень заряда, статус подключения |
| Устройства воспроизведения/записи, статус |
Хранилище и очистка (2)
Tool | Description |
| Поиск самых больших файлов на диске по размеру |
| Поиск одинаковых файлов, занимающих место (хэш MD5) |
Производительность и устранение неполадок (4)
Tool | Description |
| Обнаружение процессов с растущей памятью, избыточными дескрипторами |
| Минидампы BSOD, сбои приложений, частота сбоев |
| Проверка всех флагов «требуется перезагрузка» |
| Фазы времени загрузки, медленные элементы автозагрузки |
Безопасность (7)
Tool | Description |
| Состояния профилей, количество правил, недавние блокировки |
| Защита в реальном времени, определения, угрозы |
| Общие ресурсы SMB с аудитом разрешений |
| Локальные учётные записи, аудит администраторов, возраст пароля |
| Статус шифрования дисков по томам |
| DEP, ASLR, CFG, HVCI, Credential Guard |
| Телеметрия, рекламный идентификатор, геолокация, камера/микрофон |
Инструменты разработчика (12)
Tool | Description |
| Установленные SDK (Node, Python, .NET, Java, Go, Rust) |
| Репозитории с незакоммиченными/неотправленными изменениями |
| Глобальные пакеты, обнаружение устаревших |
| Расширения с пометкой тяжёлых/устаревших |
| Инвентаризация ключей, аудит парольных фраз, статус агента |
| Размеры VHD WSL, рекомендации по сжатию |
| Сканирование портов разработки (что запущено локально) |
| Версии .NET SDK/runtime, проверка global.json |
| Контейнеры, образы, статус демона |
| Дистрибутивы, версии, состояние запуска |
| Программы с обнаружением bloatware |
| Анализ PATH, ключевые переменные окружения |
Обслуживание (8)
Tool | Description |
| Ожидающие обновления, история, состояние автообновления |
| Несистемные задачи, обнаружение сбойных задач |
| Дополнительные компоненты (Hyper-V, WSL, IIS, Sandbox) |
| Элементы автозагрузки с оценкой влияния на загрузку |
| Отсутствующие/сбойные/устаревшие драйверы |
| Статус индексатора, размер индекса |
| Истекающие/истёкшие SSL-сертификаты |
| Точки восстановления, возраст, триггеры создания |
Мониторинг (2)
Tool | Description |
| События загрузки/выключения, оценка стабильности |
| Снимок и сравнение системных метрик с течением времени |
Рабочий процесс и продуктивность (3)
Tool | Description |
| Текущий буфер обмена, записи истории |
| Недавно открывавшиеся файлы с поиском |
| Активный план, обнаружение троттлинга |
Автоматизация (2)
Tool | Description |
| Время загрузки профиля, аудит импорта модулей |
| Службы автозапуска, обнаружение сбойных |
Дополнительная диагностика (5)
Tool | Description |
| Установленные шрифты с поиском |
| Подключённые USB-периферия и диски |
| Данные S.M.A.R.T., уровень износа, прогноз отказа диска |
| Обнаружение активного ПО записи/демонстрации экрана |
| Комплексный снимок ЦП/ОЗУ/Диск/Сеть/GPU |
Интеграции (2)
Tool | Description |
| Инвентаризация локальных моделей Ollama |
| Генерация полного отчёта о состоянии в Markdown |
Действия записи (12, требуют --allow-actions)
Tool | Description |
| Завершить процесс по PID или имени |
| Перезапустить/запустить/остановить службу Windows |
| Завершить процесс, занимающий порт |
| Удалить временные файлы для освобождения места |
| Очистить кэш DNS-резолвера |
| Навсегда удалить содержимое корзины |
| Переключить тёмную/светлую тему Windows |
| Запланировать перезагрузку системы |
| Отключить программу автозагрузки |
| Создать точку восстановления системы |
| Переключить план электропитания (Сбалансированный/Высокая производительность/и т.д.) |
| Отправить нативное уведомление 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
Флаг | Описание |
| Запустить HTTP-сервер вместо MCP stdio |
| Порт HTTP-сервера (по умолчанию: 7890) |
| Включить инструменты записи действий |
| Вывести версию и количество инструментов |
| Вывести все инструменты с описаниями |
Требования
Windows 10/11
Node.js 20+
PowerShell 5.1+ (поставляется с Windows)
Лицензия
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
- ZionDeskOAuthapp.ziondesk
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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 npm9MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to control Windows PCs by executing shell commands, managing files, capturing screenshots, and monitoring system information through a comprehensive set of MCP tools.181MIT
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmMIT