Skip to content

Commit 1c0e29c

Browse files
committed
1.2.0
1 parent 7be19f3 commit 1c0e29c

1 file changed

Lines changed: 30 additions & 204 deletions

File tree

Staging/PowerShell.MCP.psd1

Lines changed: 30 additions & 204 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
#
44
# Generated by: Yoshifumi Tsuda
55
#
6-
# Generated on: 2025/05/24
6+
# Generated on: 2025/09/17
77
#
88

99
@{
@@ -12,7 +12,7 @@
1212
RootModule = 'PowerShell.MCP.dll'
1313

1414
# Version number of this module.
15-
ModuleVersion = '1.1.7'
15+
ModuleVersion = '1.2.0'
1616

1717
# Supported PSEditions
1818
# CompatiblePSEditions = @()
@@ -24,7 +24,7 @@ GUID = '313962fa-c90b-424a-9c8a-d4a05f4a1481'
2424
Author = 'Yoshifumi Tsuda'
2525

2626
# Company or vendor of this module
27-
CompanyName = 'Unknown'
27+
CompanyName = 'Yoshifumi Tsuda'
2828

2929
# Copyright statement for this module
3030
Copyright = '(c) Yoshifumi Tsuda. All rights reserved.'
@@ -51,7 +51,7 @@ PowerShellVersion = '7.2.15'
5151
# ProcessorArchitecture = ''
5252

5353
# Modules that must be imported into the global environment prior to importing this module
54-
RequiredModules = @(@{ModuleName='PSReadLine'; ModuleVersion='2.3.4'})
54+
RequiredModules = @(@{ModuleName = 'PSReadLine'; ModuleVersion = '2.3.4'; })
5555

5656
# Assemblies that must be loaded prior to importing this module
5757
# RequiredAssemblies = @()
@@ -95,222 +95,48 @@ PrivateData = @{
9595
PSData = @{
9696

9797
# Tags applied to this module. These help with module discovery in online galleries.
98-
# Tags = @()
98+
Tags = 'MCP','AI','Assistant','PowerShell','Automation','Enterprise'
9999

100100
# A URL to the license for this module.
101-
# LicenseUri = ''
101+
LicenseUri = 'https://github.com/yotsuda/PowerShell.MCP/blob/main/LICENSE'
102102

103103
# A URL to the main website for this project.
104-
# ProjectUri = ''
104+
ProjectUri = 'https://github.com/yotsuda/PowerShell.MCP'
105105

106106
# A URL to an icon representing this module.
107107
# IconUri = ''
108108

109109
# ReleaseNotes of this module
110-
ReleaseNotes = 'PowerShell.MCP Release Notes
110+
ReleaseNotes = 'PowerShell.MCP v1.2.0 - Enterprise-Ready MCP Server
111111
112112
=== Key Features ===
113-
- PowerShell 7 as MCP Server via secure named pipe communication
114-
- Complete PowerShell ecosystem access through MCP protocol
115-
- Real-time command execution with comprehensive output capture
116-
- Built-in prompts/list endpoint with curated PowerShell examples and use cases
117-
- Enhanced safety with location context and execution awareness
113+
• PowerShell 7 as MCP Server with secure named pipe communication
114+
• Complete PowerShell ecosystem access for Claude Desktop and MCP clients
115+
• 50+ ready-to-use prompt examples for immediate productivity
116+
• Enterprise-grade security - local access only, no remote connections
117+
118+
=== Popular Examples ===
119+
• "Generate system performance HTML report and open in browser"
120+
• "Show processes consuming more than 100MB memory, sorted by CPU usage"
121+
• "Create colorful disk usage analysis charts and visualizations"
122+
• "Export installed programs to CSV and open in Excel"
123+
• "Review code files and generate development documentation"
118124
119125
=== Quick Setup ===
120126
1. Install-Module PowerShell.MCP
121-
2. Import-Module PowerShell.MCP,PSReadLine
127+
2. Import-Module PowerShell.MCP
122128
3. Configure MCP client: [ModuleBase]\bin\PowerShell.MCP.Proxy.exe
123-
4. Restart MCP client to activate integration
129+
Find path: (Get-Module PowerShell.MCP).ModuleBase
130+
4. Restart MCP client to activate
124131
125-
=== System Requirements ===
126-
- Windows 10/11 or Windows Server 2016+
127-
- PowerShell 7.2.15 or higher
128-
- PSReadLine 2.3.4 or higher
132+
=== Requirements ===
133+
Windows 10/11, PowerShell 7.2.15+, PSReadLine 2.3.4+ (auto-loaded)
129134
130-
=== Security & Architecture ===
131-
Named pipe communication ensures only local machine proxy connections.
132-
No remote access capability for enhanced security in enterprise environments.
135+
=== Documentation ===
136+
Full examples & setup guide: https://github.com/yotsuda/PowerShell.MCP#examples
137+
Security policy: https://github.com/yotsuda/PowerShell.MCP/blob/main/SECURITY.md
133138
134-
=== Setup Instructions ===
135-
136-
1. Install Module (first time only)
137-
PS> Install-Module PowerShell.MCP
138-
139-
2. Import Module
140-
PS> Import-Module PowerShell.MCP,PSReadLine
141-
(Upon import, PowerShell starts operating as an MCP server)
142-
143-
3. Verify PowerShell.MCP Installation Directory
144-
First, confirm the PowerShell.MCP module installation directory:
145-
PS> (Get-Module PowerShell.MCP).ModuleBase
146-
147-
This command will display the PowerShell.MCP installation directory path.
148-
Example: `C:\Users\[Username]\Documents\PowerShell\Modules\PowerShell.MCP\1.2.0`
149-
150-
4. Claude Desktop Configuration Example
151-
For Claude Desktop, open your configuration file with Notepad.
152-
(Windows: `%APPDATA%\Claude\claude_desktop_config.json`)
153-
154-
Add the following to your configuration file:
155-
156-
{
157-
"mcpServers": {
158-
"PowerShell": {
159-
"command": "[PowerShell.MCP Installation Directory]\\bin\\PowerShell.MCP.Proxy.exe"
160-
}
161-
}
162-
}
163-
164-
Important Notes:
165-
- 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.
301-
Improved error handling and stream ordering (Error �� Warning �� Standard).
302-
303-
=== Version 1.0.3 ===
304-
Minor bug fixes and stability improvements.
305-
306-
=== Version 1.0.2 ===
307-
Separated output streams: Standard, Error, and Warning now captured individually.
308-
309-
=== Version 1.0.1 ===
310-
Added command prompt display before execution for better user awareness.
311-
312-
=== Version 1.0.0 ===
313-
Initial release with basic MCP server functionality.
139+
⚠️ Provides complete PowerShell access. Use in trusted environments only.
314140
'
315141

316142
# Prerelease string of this module
@@ -324,10 +150,10 @@ Initial release with basic MCP server functionality.
324150

325151
} # End of PSData hashtable
326152

327-
} # End of PrivateData hashtable
153+
} # End of PrivateData hashtable
328154

329155
# HelpInfo URI of this module
330-
# HelpInfoURI = ''
156+
HelpInfoURI = 'https://github.com/yotsuda/PowerShell.MCP/wiki'
331157

332158
# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
333159
# DefaultCommandPrefix = ''

0 commit comments

Comments
 (0)