PowerShell MCP Server

A Model Context Protocol server for interacting with PowerShell. This server provides tools for executing PowerShell commands, retrieving system information, managing modules, and more.

Requirements

• Node.js 18+

• PowerShell 5.1 or PowerShell Core 7+

Related MCP server: MCP Personal Assistant Agent

Installation

1. Install dependencies:

   npm install

2. Build the project:

   npm run build

Configuration

For Claude Desktop

Edit config: $HOME/Library/Application\ Support/Claude/claude_desktop_config.json

Add to mcpServers:

For VS Code

Edit config: $HOME/Library/Application\ Support/Code/User/settings.json

Add to settings:

For Cursor IDE

Edit config: $HOME/.cursor/mcp.json

Add to mcpServers:

Available Tools

This PowerShell MCP server provides the following tools:

execute_ps

Execute a PowerShell command and get the result.

Example usage:

get_system_info

Retrieve detailed system information, including OS details, processor, memory, and PowerShell version.

Example usage:

list_modules

List all installed PowerShell modules with details like name, version, and type.

Example usage:

get_command_help

Get detailed help for a specific PowerShell command, including syntax, parameters, and examples.

Example usage:

find_commands

Search for PowerShell commands by name or pattern.

Example usage:

run_script

Run a PowerShell script file with optional parameters.

Example usage:

Development

To run in development mode:

Extending the Server

To add your own PowerShell tools:

1. Edit src/index.ts

2. Add new tools in the registerTools() method

3. Follow the existing pattern for consistent error handling

4. Build with npm run build

Adding a Tool Example

Security Considerations

• This server executes PowerShell commands directly on your system

• Commands are executed with the same privileges as the process running the MCP server

• Use caution when exposing destructive operations

• Consider implementing additional validation for sensitive commands

Troubleshooting

Common Issues

1. PowerShell execution policy restrictions

   • You may need to adjust your PowerShell execution policy to allow script execution

   • Use Set-ExecutionPolicy RemoteSigned -Scope CurrentUser to allow local scripts

2. Path not found errors

   • Ensure file paths are absolute or properly relative to the working directory

   • Use appropriate path separators for your OS

3. Command not found errors

   • Some commands may require specific modules to be installed

   • Use Install-Module ModuleName to install required modules

License

MIT