Skip to content

Releases: yotsuda/PowerShell.MCP

PowerShell.MCP v1.2.1 - Performance & User Experience Update

23 Sep 13:23
bccc34c

Choose a tag to compare

Performance & User Experience Update

This release focuses on significant performance improvements and enhanced user experience, delivering optimized stream processing and more intuitive console management.

🚀 What's New

Performance Enhancement

  • Native Stream Capture: Eliminated file I/O operations from stream capture process, replacing them with native PowerShell redirection for dramatically improved performance
  • Stream Processing Optimization: Significantly improved stream processing performance with reduced resource usage and eliminated I/O overhead
  • Memory Optimization: In-memory stream processing eliminates disk I/O bottlenecks during high-frequency command execution
  • Real-time Stream Separation: All PowerShell output streams (Success, Error, Warning, Verbose, Debug, Information) are captured directly without temporary files

🔄 Enhanced Console Management

  • Intelligent Session Detection: When start_powershell_console is called on an existing PowerShell session, it automatically executes get_current_location
  • Seamless State Transition: Improved workflow between AI and user interactions with automatic location detection
  • Better Responsiveness: Faster response times for subsequent commands after console initialization

🛠️ Stream Processing Overhaul

  • Native PowerShell Redirection: Complete redesign of how PowerShell streams are captured and processed using built-in redirection capabilities
  • Error Resilience: Enhanced error handling in stream redirection scenarios with improved stability
  • Resource Management: Better cleanup and memory management during command execution

🔧 Technical Changes

  • MCPPollingEngine.ps1: Major refactoring with 226 lines added and 158 lines removed for improved stream handling
  • PowerShellTools.cs: Enhanced console management logic with automatic location detection
  • Stream Architecture: Moved from file-based to memory-based stream capture for better performance

📦 Installation & Upgrade

🆕 New Installation

# PowerShell Gallery (Recommended)
Install-Module PowerShell.MCP -Force

🔄 Upgrading from Previous Version

# Update existing installation
Update-Module PowerShell.MCP

⚙️ Post-Installation Configuration

Important: After upgrading, you must update your MCP client configuration file to use the new version path.

Step 1: Get your new module path

Import-Module PowerShell.MCP
(Get-Module PowerShell.MCP).ModuleBase
# Example output: C:\Users\YourName\Documents\PowerShell\Modules\PowerShell.MCP\1.2.1.0

Step 2: Update your Claude Desktop configuration
Edit your Claude Desktop config file (usually at %APPDATA%\Claude\claude_desktop_config.json) and update the PowerShell command path:

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

Step 3: Restart Claude Desktop to apply the changes.

For detailed installation and configuration instructions, see:
📖 https://github.com/yotsuda/PowerShell.MCP#installation

📊 Performance Metrics

Metric v1.2.0 v1.2.1 Improvement
Stream Processing File I/O overhead In-memory processing Eliminated I/O overhead
Memory Usage Variable Optimized Reduced footprint
Error Handling Basic Enhanced Improved stability

🐛 Bug Fixes

  • Improved error handling in stream redirection scenarios
  • Enhanced stability during high-frequency command execution
  • Better resource cleanup after command completion

📖 Documentation

  • Updated README with performance improvements details
  • Enhanced technical documentation for stream processing changes

🙏 Acknowledgments

Special thanks to our community for performance feedback and testing that made these improvements possible.


Questions or Issues? Please use our GitHub Discussions for support.

PowerShell.MCP v1.2.0 - Complete Rewrite with Microsoft MCP SDK

17 Sep 09:30

Choose a tag to compare

Major Release - Complete Codebase Rewrite

This release represents a significant milestone with a complete architectural overhaul using modern Microsoft technologies.

🚀 What's New

🔄 Complete Codebase Rewrite

  • Microsoft C# MCP SDK Integration: Migrated from custom implementation to the official Microsoft C# MCP SDK for improved reliability and future compatibility
  • Enhanced Architecture: Redesigned communication layer between PowerShell module and MCP proxy for better performance and stability
  • Improved Error Handling: More robust error detection and reporting throughout the application

🖥️ PowerShell Console Management

  • Auto-Launch Tool: Added intelligent PowerShell console launcher that automatically starts and configures the PowerShell environment
  • Session Management: Better handling of PowerShell session lifecycle and automatic cleanup
  • Connection Reliability: Improved named pipe communication with automatic reconnection capabilities

📚 Enhanced User Experience

  • Built-in Prompt Library: Curated collection of ready-to-use prompts accessible directly from MCP clients like Claude Desktop
  • Interactive Examples: Practical, real-world examples for common automation tasks
  • Quick Start Prompts: Beginner-friendly prompts to help new users get started quickly

🔧 Technical Changes

  • Target Framework: Updated to .NET 9.0 for latest performance improvements
  • Single-File Deployment: Simplified distribution with self-contained executables

📦 Installation & Upgrade

🆕 New Installation

# PowerShell Gallery (Recommended)
Install-Module PowerShell.MCP -Force

🔄 Upgrading from Previous Version

# Update existing installation
Update-Module PowerShell.MCP

⚙️ Post-Installation Configuration

Important: After installation or upgrade, you must update your MCP client configuration file to use the new version.

For detailed installation and configuration instructions, see:
📖 https://github.com/yotsuda/PowerShell.MCP#installation

📖 Documentation

  • Updated README with new features and examples
  • Enhanced security documentation

🙏 Acknowledgments

Special thanks to the Microsoft MCP SDK team and our community contributors who provided feedback during the development process.


Questions or Issues? Please use our GitHub Discussions for support.