# Clone repository
git clone https://github.com/GUEPARD98/MCP-POWERSHELL.git
cd MCP-POWERSHELL

# Install dependencies
npm install

# Configure environment
Copy-Item config\.env.example config\.env
# Edit config\.env with your SSH settings

# Start server
npm start

MCP-POWERSHELL/
├── 📁 config/           # Environment configurations
│   ├── .env.example     # Configuration template
│   ├── .env.development # Development settings
│   ├── .env.production  # Production settings
│   └── .env.test       # Test settings
├── 📁 docs/            # Complete documentation
│   ├── README.md       # Detailed guide
│   ├── API.md          # API reference
│   ├── ARCHITECTURE.md # Technical architecture
│   └── SECURITY.md     # Security best practices
├── 📁 scripts/         # PowerShell automation scripts
│   ├── start.ps1       # Start server
│   ├── stop.ps1        # Stop server
│   ├── setup.ps1       # Initial setup
│   └── test.ps1        # Run tests
├── 📁 src/             # Source code
│   └── index.js        # Main MCP server
└── 📁 tests/           # Automated tests

// Example: Run 'ls -la' on remote server
{
  "name": "ssh_execute",
  "arguments": {
    "command": "ls -la",
    "host": "192.168.1.100", 
    "user": "root"
  }
}

// Example: Get Windows processes
{
  "name": "powershell_execute",
  "arguments": {
    "command": "Get-Process | Select-Object -First 10"
  }
}

// Example: Scan local network
{
  "name": "ssh_scan", 
  "arguments": {
    "target": "192.168.1.0/24"
  }
}

// Example: Get host key fingerprint
{
  "name": "ssh_keyscan",
  "arguments": {
    "host": "192.168.1.100"
  }
}

# SSH Configuration
SSH_KEY_PATH=/path/to/your/ssh/key
SSH_DEFAULT_HOST=your.server.ip
SSH_DEFAULT_USER=your_username
SSH_DEFAULT_PORT=22

# Security Settings  
SSH_STRICT_HOST_KEY_CHECKING=no
COMMAND_TIMEOUT=30000
LOG_LEVEL=info

{
  "mcpServers": {
    "ssh-powershell-mcp": {
      "command": "node",
      "args": ["path/to/MCP-POWERSHELL/src/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

# Run all tests
npm test

# Run specific test types
.\scripts\test.ps1 -TestType unit
.\scripts\test.ps1 -TestType integration
.\scripts\test.ps1 -TestType ssh