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