io.github.Jason26214/pwsh-exec-mcp

Official

by Jason26214 · Python

A minimal, transparent PowerShell 7 MCP for Windows — one tool: raw exit code, stdout, stderr.

io.github.Jason26214/pwsh-exec-mcp (MCP Server)

A minimal, transparent PowerShell 7 MCP server for Windows. It provides one tool that executes commands and returns results including the raw exit code, stdout, and stderr. The server is focused on shell/command execution using PowerShell (pwsh) within the Model Context Protocol (MCP).

🛠️ Key Features

PowerShell 7 MCP for Windows
Single tool only
Returns: raw exit code, stdout, stderr

🚀 Use Cases

Running Windows PowerShell (pwsh) commands via MCP
Capturing command outputs and error text for agent workflows

⚡ Developer Benefits

Transparent behavior with direct execution results
Clear outputs: exit code plus stdout/stderr for debugging

⚠️ Limitations

Minimal implementation: only one tool (no additional capabilities described)

Topics

ai-agentclaudeclicommand-executionmcpmodel-context-protocolpowershellpwshshellwindows

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>"
      }
    }
  }
}