🪟 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 Cabinet (.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)。

• Webapp (UI): ミリ秒以下のリンティングのために Biome を使用。厳格な noConsoleLog を強制。

• プロトコル準拠: クラッシュ耐性のあるJSON-RPC通信を保証するための、強化された stdout/stderr 分離。

• 自動化: すべてのフリート操作のための Justfile レシピ (just lint, just fix, just dev)。

• セキュリティ: bandit および safety を使用した自動監査。