1

INSTALLATION

Jonathan Miller edited this page 2026-05-25 22:06:44 -05:00

Table of Contents

• Installation
• Prerequisites
• Install
• Register with Claude Code
• Verify
• Optional Configuration
• Development
• Related

← Back to Home

Installation

Setup guide for mcp-windows -- prerequisites, build, and Claude Code registration.

---

Prerequisites

• Node.js 20.0.0+
• npm 9+
• Windows 10 or later
• PowerShell 5.1+ (included with Windows)

Install

git clone https://git.mokoconsulting.tech/MokoConsulting/mcp-windows.git
cd mcp-windows
npm install
npm run build

Register with Claude Code

Add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "mcp_windows": {
      "command": "node",
      "args": ["A:/MCP/mcp_windows/dist/index.js"]
    }
  }
}

No environment variables or config files required -- mcp-windows operates on the local system directly.

Verify

npm start

The server should output mcp_windows: server started to stderr and wait for MCP messages on stdin.

Optional Configuration

Create ~/.mcp_windows.json to customize behavior:

{
  "blockedCommands": ["Format-Volume", "Clear-Disk"],
  "allowedDirectories": [],
  "outputLineLimit": 5000,
  "commandTimeout": 30000
}

See Configuration for details.

Development

npm run dev     # Watch mode -- rebuilds on changes
npm run build   # One-time build
npm run clean   # Remove dist/

---

Related

• Configuration -- Customize blocked commands, directories, limits
• Architecture -- Source layout and execution model

---

Repo: mcp-windows · MokoStandards

Field	Value
Minimum Version	05.00.00
Platform	mcp-server
Applies To	mcp-windows

Revision	Date	Author	Description
1.0	2026-05-25	Moko Consulting	Initial version