PowerShell.MCP v1.4.0 - Cross-Platform Support: Linux & macOS

[yotsuda]

Cross-Platform Support: Linux & macOS

This release adds Linux and macOS support, enabling PowerShell.MCP to run on all major platforms.

🎉 Cross-Platform Support

Now available on Linux and macOS

Platform	Architecture	Status
Windows	x64	✅ Supported
Linux	x64	✅ New
macOS	x64 (Intel)	✅ New
macOS	arm64 (Apple Silicon)	✅ New

---

📊 What's Changed Since v1.3.9

New Features

• Linux support: Works with gnome-terminal, konsole, xfce4-terminal, xterm, lxterminal, mate-terminal, terminator, tilix, alacritty, kitty
• macOS support: Works with Terminal.app on both Intel and Apple Silicon Macs
• Login shell integration: Uses $SHELL -l -c to properly inherit user environment (PATH, etc.)
• Home directory start: pwsh console starts in user's home directory with -WorkingDirectory ~
• Multiple sessions: Removed Named Pipe existence check to allow multiple PowerShell.MCP sessions

Improvements

• Version mismatch error now shows Get-MCPProxyPath -Escape tip on Windows
• Version mismatch error now shows Get-MCPProxyPath tip on Linux/macOS
• Added GitHub Actions CI/CD for cross-platform testing
• PSReadLine is automatically removed on Linux/macOS (not supported)

Bug Fixes

• Fixed nullable reference warnings in TextFileUtility and ShowTextFileCmdlet
• Fixed Update-MatchInFile help to show -OldText instead of -Contains

---

📄 Installation & Upgrade

Windows

# New installation
Install-Module PowerShell.MCP -Force

# Upgrade existing
Update-Module PowerShell.MCP

Linux / macOS

# Install
pwsh -Command "Install-Module PowerShell.MCP -Scope CurrentUser -Force"

# Set execute permission
chmod +x $(pwsh -Command "Import-Module PowerShell.MCP; Get-MCPProxyPath")

Update MCP Configuration

1. Get new proxy path:

# Windows (escaped for JSON)
Get-MCPProxyPath -Escape

# Linux / macOS
Get-MCPProxyPath

2. Update claude_desktop_config.json with the path from step 1:

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Users\\YourName\\Documents\\PowerShell\\Modules\\PowerShell.MCP\\1.4.0\\bin\\win-x64\\PowerShell.MCP.Proxy.exe"
    }
  }
}

3. Restart Claude Desktop (or Claude Code)

📖 Full Guide: https://github.com/yotsuda/PowerShell.MCP#quick-start

---

Full Documentation: https://github.com/yotsuda/PowerShell.MCP

Questions? GitHub Discussions | Report Issues: GitHub Issues

⚠ Security Notice: Provides complete PowerShell access. Use in trusted environments only.

---

This discussion was created from the release PowerShell.MCP v1.4.0 - Cross-Platform Support: Linux & macOS.