PowerShell MCP Server

A Model Context Protocol (MCP) server for automating Windows PowerShell tasks using Python. This server enables programmatic execution of PowerShell scripts, clipboard operations, and terminal output capture via a JSON-RPC interface.

Features

Execute PowerShell Scripts: Paste and run PowerShell scripts in Windows Terminal using the clipboard.
Clipboard Access: Retrieve the current clipboard content.
Terminal Screenshot: Capture the output of the PowerShell terminal as an image.

Requirements

Windows OS ( for windows only)
Python 3.8+
pyautogui
pygetwindow
pyperclip
psutil
Pillow

Install dependencies:

pip install uv && uv sync && uv pip install -e .

Usage

Start the server:

uv run powershell-mcp

The server communicates via JSON-RPC over stdin/stdout.

Available Tools

execute_pwsh_script: Execute a PowerShell script by pasting it into the terminal.
get_clipboard: Get the current clipboard content.
capture_pwsh_response: Capture a screenshot of the PowerShell terminal output.

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "execute_pwsh_script",
    "arguments": {
      "script": "Get-Process",
      "timeout": 30
    }
  }
}

Basic configuration on claude desktop

Open claude desktop
Go to file -> settings -> developer -> edit config

{
  "globalShortcut": "",
  "mcpServers": {
    "powershell-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "D:\\MCP antropic\\powershell-mcp", # change to your path
        "run",
        "powershell-mcp"
      ]
    }
  }
}

Project Structure

pyproject.toml
README.md
uv.lock
config/
src/
  powershell_mcp/
    main.py
temp/
tests/
  __init__.py

License

MIT License

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A server that enables programmatic execution of PowerShell scripts, clipboard operations, and terminal output capture via a JSON-RPC interface.

Related MCP Servers

mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
mcp-cli-exec MCP Server
jakenuts
A
security
F
license
A
quality
A CLI command execution server that enables running shell commands with structured output, providing detailed execution results including stdout, stderr, exit code, and execution duration.
Last updated -
2
16
TypeScript
MCP Server
mokemoke0821
-
security
F
license
-
quality
A cross-platform shell command execution server that supports Windows, macOS, and Linux environments with PowerShell, CMD, GitBash, and Bash shells, optimized for Japanese language environments.
Last updated -
24
JavaScript
MCP Terminal Server
cwmoore-ai
-
security
A
license
-
quality
A lightweight FastAPI server that allows remote execution of shell commands on Windows, with real-time output streaming and security features like API key authentication and rate limiting.
Last updated -
Python
MIT License

View all related MCP servers

PowerShell MCP Server