You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Replace `[PowerShell.MCP Installation Directory]` with the actual path confirmed in step 3
166
-
- In JSON files, backslashes must be escaped as `\\`
167
-
- Restart the Claude Desktop application after adding the configuration to apply changes
168
-
169
-
5. Other MCP Clients
170
-
Other MCP clients can also be used by configuring stdio connections to PowerShell.MCP.Proxy.exe.
171
-
172
-
=== Architecture Overview ===
173
-
This module operates with the following architecture:
174
-
1. PowerShell Module: Functions as named-pipe-based MCP server
175
-
2. Stdio Proxy Server: Bridges between MCP clients and named pipe MCP server
176
-
3. MCP Client: Connects to proxy server via stdio for operations
177
-
178
-
=== Prompt Examples ===
179
-
180
-
Basic System Information:
181
-
- "Tell me the current date and time"
182
-
- "Check the PowerShell version"
183
-
- "Display system environment variables"
184
-
- "Show me disk usage"
185
-
186
-
System Monitoring and Analysis:
187
-
- "Show me all processes consuming more than 100MB of memory, sorted by CPU usage"
188
-
- "Display 5 running Windows services"
189
-
- "Show me the list of directories in the current folder"
190
-
- "Display top 5 processes by memory usage"
191
-
192
-
Practical Calculations and Data Processing:
193
-
- "Calculate the date 30 days from today"
194
-
- "Generate a 12-character random password"
195
-
- "Calculate the total file size for a specific extension"
196
-
197
-
File and Folder Operations:
198
-
- "Compare the contents of two folders and show the differences"
199
-
- "Display the top 10 recently updated files"
200
-
201
-
Network and Connectivity:
202
-
- "Check if a specific port is open"
203
-
- "Query DNS records and display results"
204
-
205
-
Advanced Integration and Report Generation:
206
-
- "Generate system information as an HTML report and open it in browser"
207
-
- "Create an HTML report of system errors from the last 3 days and open it in browser"
208
-
- "Visualize process usage as an HTML dashboard and display in browser"
209
-
- "Create a colorful HTML chart of disk usage analysis and display automatically"
210
-
- "Visualize network connection history as HTML timeline"
211
-
212
-
System Administration Tasks:
213
-
- "Export a list of installed programs to CSV and open in Excel"
214
-
- "Search for specific application settings in the registry"
215
-
216
-
Data Analysis and Reporting:
217
-
- "Extract warnings and errors from Windows event logs"
218
-
- "Create a system performance overview report"
219
-
- "Explain the steps for creating the current report"
220
-
- "Display folder structure hierarchically"
221
-
222
-
Automation and Efficiency:
223
-
- "Auto-generate reports in specified formats"
224
-
225
-
Creative Tasks:
226
-
- "Visualize error trends in log files with graphs in HTML"
227
-
- "Generate QR codes (encode strings)"
228
-
- "Display long-running processes with colorful progress bars"
229
-
- "Visualize folder size analysis in TreeMap-style HTML"
230
-
231
-
Developer Features:
232
-
- "Run syntax checks on PowerShell scripts"
233
-
- "Generate documentation from comment-based help"
234
-
- "Analyze module dependencies"
235
-
- "Calculate code metrics and evaluate quality"
236
-
- "Please review the .cs files under c:\folder"
237
-
- "Create patch files for code changes and apply with git apply"
238
-
239
-
PowerShell-Specific Advanced Features:
240
-
- "Check the cmdlets included in imported modules"
241
-
- "Check Get-Date cmdlet parameters with Get-Help cmdlet and try several examples with those parameters"
242
-
- "Send several complex commands that you know to the PowerShell console with explanations. Do not execute them."
243
-
- "Create processing examples combining multiple cmdlets using pipelines"
244
-
- "Use PowerShell''s help system to display detailed information about specific commands"
245
-
- "How do you find using PowerShell.MCP? Please share your thoughts and experiences"
246
-
247
-
=== Software Requirements ===
248
-
- Windows 10 (version 1607 or higher) or Windows 11
249
-
- Windows Server 2016 or higher
250
-
- PowerShell 7.2.15 or higher
251
-
- PSReadLine (version 2.3.4 or higher)
252
-
253
-
=== Package Contents ===
254
-
- PowerShell.MCP Module: Named-pipe-based MCP server functionality
255
-
- PowerShell.MCP.Proxy.exe: Stdio proxy server for MCP client compatibility
256
-
257
-
=== Known Limitations ===
258
-
- Commands executed via MCP cannot be canceled with Ctrl+C.
259
-
- Security Note: Provides complete PowerShell access - use only in trusted environments
260
-
261
-
=== What Makes This Special? ===
262
-
This isn''t just another tool - it''s a game changer! By connecting MCP clients to the entire Windows ecosystem through PowerShell, you''re essentially giving them superpowers. From system administration to creative automation, the possibilities are limitless.
263
-
264
-
Note: This module has been tested and verified with Claude Desktop. It should work with other MCP clients as well, but this is untested.
265
-
266
-
Are you ready to revolutionize your AI assistant experience? Import the module and start commanding your system like never before!
267
-
268
-
=== PowerShell.MCP Release History ===
269
-
270
-
=== Version 1.2.0 ===
271
-
Rewritten with MS C# MCP SDK entirely. Added comprehensive prompts list.
272
-
Added start_powershell_console tool to enhance user experience.
273
-
274
-
=== Version 1.1.7 ===
275
-
Added current location context to command output for better execution awareness.
276
-
277
-
=== Version 1.1.6 ===
278
-
Fixed timeout-related duplicate execution issues with extended timeout handling.
279
-
280
-
=== Version 1.1.5 ===
281
-
Removed automatic retry mechanism preventing duplicate execution of long-running commands.
282
-
283
-
=== Version 1.1.4 ===
284
-
Added getCurrentLocation tool for improved PowerShell console operation safety and efficiency.
285
-
286
-
=== Version 1.1.3 ===
287
-
Enhanced output capture for What if:, VERBOSE:, DEBUG:, and WARNING: host streams.
288
-
289
-
=== Version 1.1.2 ===
290
-
Code cleanup and removal of obsolete components for better maintainability.
291
-
292
-
=== Version 1.1.1 ===
293
-
Removed 5,000-character input limit for unlimited command length support.
294
-
295
-
=== Version 1.1.0 ===
296
-
Major security enhancement: Switched from HTTP to named pipes, preventing remote access.
297
-
Removed output character limits for unlimited response handling.
298
-
299
-
=== Version 1.0.4 ===
300
-
Expanded limits: Input to 5,000 chars, output to 8,000 chars, removed line limits.
0 commit comments