A minimal, transparent Model Context Protocol (MCP) server for Windows PowerShell 7. It exposes a single tool to report raw exit codes, stdout, and stderr, enabling deterministic model-context interactions in constrained environments.

🛠️ Key Features

Minimal MCP server with one tool: raw exit code, stdout, stderr
Windows PowerShell 7 compatibility
Transparent, straightforward behavior suitable for model-context use

🚀 Use Cases

Embedding PowerShell command execution within MCP workflows
Deterministic reporting of command results to AI agents
Lightweight MCP server for model-context experimentation

⚡ Developer Benefits

Simple, focused implementation with minimal surface area
Clear data outputs (exit code, stdout, stderr) for reproducible contexts
Easy integration into Windows-based automation pipelines

⚠️ Limitations

Single-tool MCP server; limited to raw exit, stdout, stderr
PowerShell 7 on Windows required to run as described
Minimal feature set; no advanced parsing or multi-command workflows

Install

Configuration

Environment variables

PWSH_EXEC_DEFAULT_DIR

Default working directory for commands (defaults to %TEMP%/pwsh-exec).

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "pwsh-exec-mcp": {
      "command": "uvx",
      "args": [
        "pwsh-exec"
      ],
      "env": {
        "PWSH_EXEC_DEFAULT_DIR": "<YOUR_PWSH_EXEC_DEFAULT_DIR>"
      }
    }
  }
}

io.github.Jason26214/pwsh-exec-mcp