Windows Developer MCP Server

A production-grade Model Context Protocol (MCP) server for Windows developer environments. Built on FastMCP, it equips AI assistants (e.g. LM Studio, Claude Desktop, VS Code extension) with comprehensive capabilities for terminal execution, filesystem navigation, git operations, runtime inspections, container management, SQLite queries, web browser interaction, and security-sandboxed system control.

Key Features

• 🖥️ Windows Terminal Provider: PowerShell & CMD execution with execution limits, custom working directory support, and background session tracking.

• 📁 Filesystem Provider: Safe file reading, structured writing, directory trees, file searches, hash generation, and metadata inspection.

• 🌿 Git Provider: Repository status, commit logs, branch management, diffs, and staging support.

• 🐍 Python Provider: Virtual environment management, package inspection, module verification, and version details.

• 🟢 Node.js Provider: Node & npm version detection, global/local package details, and script runner inspection.

• 🐳 Docker Provider: Container listing, inspection, log tailing, image management, and compose state checks.

• ⚙️ Windows System Provider: Hardware/OS info, process manager, environment variable inspector, and system metrics.

• 🌐 Network Provider: DNS resolution, ping utilities, port connectivity checks, and HTTP/HTTPS header inspections.

• 🗄️ SQLite Provider: Database schema inspection, safe parameterized queries, table listing, and index overview.

• 📊 Project Provider: Automated project type detection (Python, Node, Rust, Go, C#), dependency tree analysis, and structure summary.

• 🐙 GitHub Provider: Public/private repository inspection, issue tracking, PR status, release fetching, and search via GitHub API / gh CLI.

• 🌐 Browser Provider: Web page fetching, HTML text extraction, URL status checks, and launching Windows default web browser.

• 🛡️ Security Guardrails: Strict path-traversal sandboxing, read-only mode, command allowlisting, destructive command confirmation, and audit logging.

Related MCP server: allcanuse-mcp

Architecture & Security Model

                    ┌────────────────────────┐
                    │       MCP Client       │
                    │ (LM Studio / Claude)   │
                    └───────────┬────────────┘
                                │ JSON-RPC (stdio)
                                ▼
                    ┌────────────────────────┐
                    │      server.py         │
                    │   (FastMCP Engine)     │
                    └───────────┬────────────┘
                                │
          ┌─────────────────────┴─────────────────────┐
          ▼                                           ▼
┌──────────────────┐                       ┌──────────────────┐
│  Security Layer  │                       │ ProviderRegistry │
│  - Path Sandbox  │                       └────────┬─────────┘
│  - Command Audit │                                │ Auto-Discovers
│  - Read-Only     │                                ▼
└──────────────────┘                       ┌──────────────────┐
                                           │  12 Providers    │
                                           │  (40+ Tools)     │
                                           └──────────────────┘

Security Features

1. Workspace Sandboxing: All file read/write operations are constrained to the configured workspace root (workspace.path). Path traversal outside the workspace triggers WorkspaceViolationError.

2. Command Validation: Built-in regex filters block destructive OS commands (format, del /f /s /q C:\*, shutdown, reg delete, Set-ExecutionPolicy Bypass).

3. Read-Only Mode: Setting read_only = true in config.toml instantly converts the server into a non-destructive inspection tool.

4. Destructive Command Confirmation: Commands altering filesystem state require explicit confirm = true parameter flags.

5. Audit Logging: All tool invocations and security checks are recorded to rotated logs in logs/.

Installation

Prerequisites

• Windows 10 / 11 or Windows Server 2019+

• Python 3.12+

1. Clone & Setup Virtual Environment

git clone https://github.com/peeyushcodes/windows-developer-mcp.git
cd windows-developer-mcp

# Create virtual environment
python -m venv .venv
.\.venv\Scripts\Activate.ps1

2. Install Package with Dev Dependencies

pip install -e .[dev]

Or using uv:

uv pip install -e .[dev]

Configuration

The server is configured via config.toml in the project root:

[server]
name = "Windows Developer MCP"
version = "0.1.0"

[workspace]
path = "."                  # Root directory for file operations
read_only = false           # Set to true to block all modifications

[security]
timeout = 60                # Default command execution timeout (seconds)
require_confirmation = true # Require confirm=true for destructive actions
max_output_length = 50000   # Maximum characters returned per tool execution

[providers]
terminal   = true
filesystem = true
git        = true
python     = true
node       = true
docker     = true
windows    = true
network    = true
sqlite     = true
project    = true
github     = true
browser    = true

Integration with MCP Clients

LM Studio Configuration

Add to your LM Studio mcp_config.json:

{
  "mcpServers": {
    "windows-developer-mcp": {
      "command": "C:\\Users\\<YourUsername>\\terminal-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\<YourUsername>\\terminal-mcp\\server.py"]
    }
  }
}

Claude Desktop Configuration

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "windows-developer-mcp": {
      "command": "C:\\Users\\<YourUsername>\\terminal-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\<YourUsername>\\terminal-mcp\\server.py"]
    }
  }
}

Provider & Tool Matrix

Testing & Quality Assurance

Run the full test suite using pytest:

.\.venv\Scripts\pytest.exe -v

Run code formatting and linting audit:

.\.venv\Scripts\ruff.exe check .

License

MIT License — see LICENSE for details.