windows-server-mcp 1.0.0__tar.gz

windows_server_mcp-1.0.0/.gitattributes

@@ -0,0 +1,10 @@
+* text=auto
+
+*.py text eol=lf
+*.md text eol=lf
+*.json text eol=lf
+*.toml text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.ts text eol=lf
+*.js text eol=lf

windows_server_mcp-1.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: Bug report
+about: Report a problem with a Windows MCP tool
+title: "[Bug]: "
+labels: bug
+assignees: ""
+---
+
+## Summary
+
+## Tool
+
+## Environment
+
+- Windows version:
+- Python version:
+- MCP client:
+- Administrator terminal: yes/no
+
+## Steps to Reproduce
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Logs or Output
+
+Remove secrets, tokens, and private paths before posting.

windows_server_mcp-1.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,15 @@
+---
+name: Feature request
+about: Suggest a new Windows management tool or improvement
+title: "[Feature]: "
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+## Proposed Tool or Behavior
+
+## Safety Considerations
+
+Should this be read-only, dry-run by default, reversible, or destructive?

windows_server_mcp-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,81 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  python:
+    name: Python ${{ matrix.python-version }} / ${{ matrix.mcp }}
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.13"]
+        # Test both generations of the official MCP SDK:
+        # 1.x exposes FastMCP, 2.x renamed it to MCPServer.
+        mcp: ["mcp>=1.12,<2", "mcp>=2,<3"]
+    defaults:
+      run:
+        shell: pwsh
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e . pytest
+          pip install "${{ matrix.mcp }}"
+
+      - name: Compile Python
+        run: python -m compileall windows_server_mcp
+
+      - name: Run tests (imports, 100 registered tools)
+        run: python -m pytest -q tests
+
+  package:
+    name: Build package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          python -m twine check dist/*
+
+  vscode-extension:
+    name: VS Code extension
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: pwsh
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        working-directory: vscode-extension
+        run: npm ci
+
+      - name: Compile extension
+        working-directory: vscode-extension
+        run: npm run compile

windows_server_mcp-1.0.0/.github/workflows/pages.yml

@@ -0,0 +1,41 @@
+name: Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "website/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

windows_server_mcp-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade pip build twine
+          python -m build
+          python -m twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Upload to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/windows-server-mcp/
+    permissions:
+      id-token: write   # required for PyPI Trusted Publishing (no API token needed)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

windows_server_mcp-1.0.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+.venv/
+venv/
+build/
+dist/
+*.egg-info/
+
+# Node / VS Code extension
+vscode-extension/node_modules/
+vscode-extension/out/
+vscode-extension/*.vsix
+.vscode-test/
+
+# Local tooling
+.env
+.env.*
+!.env.example
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS/editor
+.DS_Store
+Thumbs.db
+.vscode/
+!.vscode/extensions.json

windows_server_mcp-1.0.0/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+## 1.0.0 — first release as `windows-server-mcp`
+
+### Added
+
+- **Encoding-safe file tools** (100 tools in total): `read_text_file`, `write_text_file`
+  and `normalize_text_file_encoding` always use UTF-8 **without BOM**, so source code and
+  emojis are never corrupted by PowerShell 5.1's UTF-16 / ANSI / BOM defaults.
+
+### Fixed
+
+- **Garbled characters in tool output** (accents, emojis, Chinese-looking text): every
+  PowerShell call now forces UTF-8 on the console and `$OutputEncoding`, and the output is
+  decoded as UTF-8.
+- `_harden_stdio` no longer re-points foreign `StreamHandler`s (e.g. pytest's capture
+  handlers), which broke test teardown.
+
+### Fixed
+
+- **Tool calls could hang forever and freeze the server.** About half of the
+  PowerShell/subprocess calls had no timeout, and children inherited the MCP
+  stdio `stdin`. Every external command now goes through
+  `windows_server_mcp.shell.run`, which enforces a deadline (60 s by default),
+  closes `stdin`, hides console windows and kills the whole process tree on
+  timeout, returning a clear "timed out" message instead of hanging.
+- `execute_powershell` gains `timeout_seconds` (default 60, max 3600). With
+  `require_admin=true` it no longer waits forever on an unseen UAC prompt, runs
+  the script from a temp file (fixes quoting breakage) and now returns the
+  command's output.
+- Tools now run in a worker thread, so on `mcp` 1.x a slow call can no longer
+  block the event loop and make the whole server unresponsive.
+- **Logging can no longer freeze the server.** Under `pythonw.exe` (launched by a
+  bridge), `stderr` is often an unread pipe; once it filled, the next log write
+  blocked forever. The server now writes its logs and `stderr` to
+  `%LOCALAPPDATA%\windows-server-mcp\server.log` / `stderr.log`. Each tool call
+  logs `tool start` / `tool finished`, so a `start` with no `finished` shows
+  which tool hung.
+- Tool calls have a hard deadline (180 s; longer for installs and for
+  `execute_powershell` with a big `timeout_seconds`). If a thread blocks inside
+  Python itself the call is abandoned with an error and the server stays alive.
+- `find_process_locking_file` scans in a separate, killable process, because
+  `psutil.open_files()` can block forever on some Windows handles.
+- `get_gpu_usage` and similar tools report a timeout instead of a misleading
+  "no data" result.
+- **Compatibility with `mcp` 2.x.** The MCP Python SDK v2 (released 2026-07-28)
+  renamed `FastMCP` to `MCPServer` and removed the `mcp.server.fastmcp` module
+  with no deprecation shim, so a fresh `pip install` crashed on start-up with
+  `ModuleNotFoundError`. `server.py` now imports `MCPServer` from
+  `mcp.server.mcpserver` and falls back to `FastMCP` on `mcp` 1.x.
+- Removed the unused `fastmcp` dependency (the standalone package was never
+  imported; the server always used the SDK's built-in class).
+
+### Changed
+
+- Dependency range is now `mcp>=1.12,<3` so the next major release cannot break
+  installs silently again.
+- Server name shown to clients is now `Windows Management` and the package
+  version is reported in the MCP `serverInfo`.
+- CI runs on Python 3.10 and 3.13 against both `mcp` 1.x and `mcp` 2.x.
+
+### Added
+
+- `get_server_status` tool (97 tools in total): server and MCP SDK versions, loaded tool count and whether the server is elevated.
+- `tests/` with import, tool-count and `list_tools()` checks (they can also be
+  run on Linux/macOS thanks to a `conftest.py` that stubs `winreg`/`windll`).
+- English and Spanish READMEs (`README.md`, `README.es.md`).
+
+## 0.3.0
+
+- Expanded the server to 96 Windows management tools.
+- Added storage cleanup reports and safer Recycle Bin deletion workflows.
+- Added GPU, driver, disk health, Windows Update, restore point, WSL, Hyper-V, printer, audio, Bluetooth, firewall, and uninstall maintenance tools.
+- Added VS Code extension wrapper.
+- Added MCP Registry metadata and publishing documentation.
+
+---
+
+Original project by [Ahmed Laminou Amadou](https://github.com/AhmedLaminou).

windows_server_mcp-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Code of Conduct
+
+This project expects respectful, constructive collaboration.
+
+Be kind, assume good intent, and focus critique on the work rather than the person. Harassment, threats, hate speech, and sustained disruptive behavior are not acceptable.
+
+Maintainers may remove comments, issues, or contributions that violate this standard.

windows_server_mcp-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing
+
+Thanks for helping improve Windows Management MCP Server.
+
+## Development Workflow
+
+1. Create a virtual environment.
+2. Install the package in editable mode.
+3. Make focused changes.
+4. Run the Python compile check.
+5. Compile the VS Code extension if extension files changed.
+6. Update docs when tools or behavior change.
+
+```powershell
+python -m venv venv
+.\venv\Scripts\Activate.ps1
+pip install -e .
+.\venv\Scripts\python.exe -m compileall windows_server_mcp
+pip install pytest
+.\venv\Scripts\python.exe -m pytest -q tests
+```
+
+For the VS Code extension:
+
+```powershell
+cd vscode-extension
+npm install
+npm run compile
+```
+
+## Tool Safety Guidelines
+
+- Prefer read-only report tools first.
+- Add `dry_run` defaults for destructive or broad mutation tools.
+- Clearly document privilege requirements.
+- Avoid permanent deletion when Recycle Bin behavior is possible.
+- Keep PowerShell commands scoped and parameterized.
+
+## Pull Requests
+
+Please include:
+
+- What changed.
+- Which tools are affected.
+- Verification commands run.
+- Any Administrator privilege requirements.