PowerShell.MCP v1.2.5 - Enhanced Text File Operations

[yotsuda]

Enhanced Text File Operations

Building on v1.2.4's foundation, this release adds validation improvements, a new cmdlet, and performance optimizations.

✨ What's New

🆕 New Cmdlet: Test-TextFileContains

Check if text exists in files - returns Boolean for easy conditional logic:

# Check if error exists in log
if (Test-TextFileContains app.log -Contains "ERROR") {
    Write-Host "Errors found!"
}

# Check with regex, limit search range
Test-TextFileContains config.ini -Pattern "Port\s*=\s*\d+" -LineRange 1,50

---

🔧 Enhancements

Improved Cmdlet Usability

Set-LinesToFile - Now creates files and supports whole-file replacement:

# Create new file or replace entire content (no -LineRange needed)
Set-LinesToFile config.txt -Content "Line 1", "Line 2", "Line 3"

Add-LinesToFile - Simplified new file creation:

# Create new file - parameters now optional
Add-LinesToFile newfile.txt -Content "First line", "Second line"

Stronger Validation

LineRange Validation - Rejects invalid ranges:

Show-TextFile file.txt -LineRange 10,5
# Error: LineRange start (10) must be less than or equal to end (5)

Parameter Mutual Exclusion - Clearer error messages:

Update-TextFile file.txt -Contains "old" -Pattern "regex" -Replacement "new"
# Error: Cannot specify both -Contains and -Pattern

1-Based Line Numbers - Strict validation (must be ≥ 1):

Add-LinesToFile file.txt -LineNumber 0 -Content "Invalid"
# Error: LineNumber must be 1 or greater

---

⚡ Performance

Added RegexOptions.Compiled to pattern-based operations for faster repeated matching in large files:

• Update-TextFile -Pattern
• Show-TextFile -Pattern
• Remove-LinesFromFile -Pattern

---

🔐 Security

CVE-2024-43483 Mitigation - Added explicit dependency on System.Formats.Asn1 9.0.9

---

📋 Complete Feature Set

All Text File Cmdlets

• Show-TextFile - Display with line numbers
• Test-TextFileContains - NEW Boolean text check
• Update-TextFile - Find and replace
• Add-LinesToFile - Insert lines
• Set-LinesToFile - Replace lines or create files
• Remove-LinesFromFile - Delete line ranges

---

🔄 Installation & Upgrade

# New installation
Install-Module PowerShell.MCP -Force

# Upgrade existing
Update-Module PowerShell.MCP

Update MCP Configuration

1. Get new module path:

(Get-Module PowerShell.MCP).ModuleBase

2. Update claude_desktop_config.json:

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Path\\To\\PowerShell.MCP\\1.2.5\\bin\\PowerShell.MCP.Proxy.exe"
    }
  }
}

3. Restart Claude Desktop

📖 Full Guide: https://github.com/yotsuda/PowerShell.MCP#quick-start

---

💡 Usage Examples

# NEW: Test before updating
if (Test-TextFileContains config.ini -Pattern "Port\s*=") {
    Update-TextFile config.ini -Pattern "Port\s*=\s*(\d+)" -Replacement "Port = 9000"
}

# NEW: Create file in one command
Add-LinesToFile notes.txt -Content "Task 1", "Task 2", "Task 3"

# NEW: Replace entire file
Set-LinesToFile app.config -Content "# Config", "Setting1=Value1"

# From v1.2.4 (still supported)
Show-TextFile config.txt
Update-TextFile config.txt -Contains "old" -Replacement "new"
Remove-LinesFromFile config.txt -LineRange 5,10

---

📊 v1.2.4 vs v1.2.5 Comparison

Feature	v1.2.4	v1.2.5
Text File Cmdlets	5 cmdlets	6 cmdlets (+Test-TextFileContains)
Boolean Text Check	Manual parsing	✓ Test-TextFileContains
Set-LinesToFile File Creation	Existing files only	✓ Creates new files
Add-LinesToFile New Files	Required -AtEnd or -LineNumber	✓ Optional parameters
LineRange Validation	Basic	✓ Rejects start > end
Parameter Validation	Basic	✓ Mutual exclusion checks
1-Based Line Numbers	Enforced	✓ Strict validation
Regex Performance	Standard	✓ Compiled for speed
Security	Standard	✓ CVE-2024-43483 patched
Get-Help Documentation	Complete	✓ LLM-optimized

Full Documentation: https://github.com/yotsuda/PowerShell.MCP

Questions? GitHub Discussions

---

⚠ Security Notice: Provides complete PowerShell access. Use in trusted environments only.

---

This discussion was created from the release PowerShell.MCP v1.2.5 - Enhanced Text File Operations.