Powershell.MCP

Name: Powershell.MCP
Author: yotsuda

@yotsuda

Repository

About Powershell.MCP

Enables PowerShell console to function as an MCP server for Claude Desktop.

#powershell #ai-agent #ai-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Users\\YourName\\Documents\\PowerShell\\Modules\\PowerShell.MCP\\1.3.3\\bin\\PowerShell.MCP.Proxy.exe"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Powershell.MCP?

Powershell.MCP is a tool that enables AI assistants (such as Claude Desktop) to execute any PowerShell commands and CLI tools within a persistent PowerShell console. It is built for users who want to collaborate with AI in a shared, stateful PowerShell session across Windows, Linux, or macOS.

How to use Powershell.MCP?

Install the PowerShell module via Install-Module PowerShell.MCP, then obtain the proxy path with Get-MCPProxyPath. Configure your MCP client (e.g., Claude Desktop) to use that proxy as an MCP server. Restart the client to start interacting with the PowerShell console.

Key features of Powershell.MCP

Shared PowerShell console between user and AI
Persistent session state (directory, modules, variables)
Instant command execution with no process startup delay
Real-time streaming output with separated streams
Access to thousands of PowerShell Gallery modules and CLI tools
LLM‑optimized text file operations up to 100× faster
7 built‑in prompts for common workflows
Local‑only communication via named pipes

Use cases of Powershell.MCP

Automating repetitive system administration tasks
Collaborative script development with AI assistance
Managing cloud resources (Azure, AWS, Google Cloud) via PowerShell modules
Exploring and learning PowerShell through interactive demos
Processing large text files efficiently with specialized cmdlets

FAQ from Powershell.MCP

What are the security implications of using Powershell.MCP?

Powershell.MCP provides complete PowerShell access to your system. Malicious use could result in severe damage. It is designed for trusted environments only, with every executed command visible in the console and no network exposure.

What are the prerequisites for Powershell.MCP?

PowerShell 7.2 or higher is required on all platforms. A compatible GUI desktop is needed on Linux, and Windows requires Windows 10/11 or Server 2016+. Claude Desktop is strongly recommended as the MCP client.

Does Powershell.MCP work cross‑platform?

Yes, it supports Windows, Linux (Ubuntu 22.04+, Debian 11+, RHEL 8+), and macOS 12+. The proxy binary is platform‑specific (win‑x64, linux‑x64, osx‑arm64, osx‑x64).

How does Powershell.MCP handle session state?

The current directory, imported modules, authenticated sessions, variables, functions, and mounted PSDrives persist throughout the entire session without needing re‑initialization between commands.

Does Powershell.MCP require a RAG system or context grounding?

No. You can gather necessary documents in a folder and tell the AI to check that folder. The AI instantly accesses all the knowledge without complex RAG infrastructure.