SSH-PowerShell MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SSH-PowerShell MCP Server run 'df -h' on server 192.168.1.100 to check disk space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SSH-PowerShell MCP Server
π Enterprise-grade Model Context Protocol (MCP) server for secure SSH and PowerShell command execution with Claude Desktop.
β¨ Features
οΏ½ Secure SSH command execution on remote servers
β‘ Local PowerShell integration for Windows automation
π‘οΈ Enterprise security with SSH key authentication
π Network scanning and SSH port discovery
π SSH key verification and host key scanning
π Comprehensive logging and error handling
π― Claude Desktop optimized for seamless AI integration
Related MCP server: SSH Read-Only MCP Server
οΏ½π Quick Start
# 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π Project Structure
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π οΈ Available Commands
Command | Description |
| Start MCP server |
| Run test suite |
| Development mode with PowerShell scripts |
| Initial configuration |
β‘ MCP Tools
π ssh_execute
Execute commands on remote SSH servers
// Example: Run 'ls -la' on remote server
{
"name": "ssh_execute",
"arguments": {
"command": "ls -la",
"host": "192.168.1.100",
"user": "root"
}
}π» powershell_execute
Execute PowerShell commands locally
// Example: Get Windows processes
{
"name": "powershell_execute",
"arguments": {
"command": "Get-Process | Select-Object -First 10"
}
}π ssh_scan
Scan network for SSH services
// Example: Scan local network
{
"name": "ssh_scan",
"arguments": {
"target": "192.168.1.0/24"
}
}π ssh_keyscan
Verify SSH host keys
// Example: Get host key fingerprint
{
"name": "ssh_keyscan",
"arguments": {
"host": "192.168.1.100"
}
}π§ Configuration
Environment Setup
Copy
config/.env.exampletoconfig/.envConfigure your SSH settings:
# 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=infoClaude Desktop Integration
The server automatically configures Claude Desktop. Manual setup:
{
"mcpServers": {
"ssh-powershell-mcp": {
"command": "node",
"args": ["path/to/MCP-POWERSHELL/src/index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}οΏ½ Security
β SSH key authentication only (no passwords)
β Command sanitization with shell-escape
β Environment isolation for different configurations
β Comprehensive input validation
β Secure credential handling
See SECURITY.md for detailed security practices.
π Documentation
Complete Guide - Detailed installation and usage
API Reference - Full MCP API documentation
Architecture - Technical design and diagrams
Security Guide - Security best practices
π§ͺ Testing
# Run all tests
npm test
# Run specific test types
.\scripts\test.ps1 -TestType unit
.\scripts\test.ps1 -TestType integration
.\scripts\test.ps1 -TestType sshπ€ Contributing
Fork the repository
Create feature branch (
git checkout -b feature/amazing-feature)Commit changes (
git commit -m 'Add amazing feature')Push to branch (
git push origin feature/amazing-feature)Open Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
πββοΈ Support
π Check the documentation
π Report issues on GitHub Issues
π¬ Join discussions in GitHub Discussions
π Acknowledgments
Model Context Protocol for the excellent SDK
Claude Desktop for AI integration capabilities
The open-source community for inspiration and tools
π’ Enterprise Ready | π Secure by Design | β‘ Claude Optimized
Made with β€οΈ by GUEPARD98
Available Tools
4 toolspowershell_executeC
Ejecutar comandos PowerShell localmente
Inputs: command (required).
ssh_executeC
Ejecutar comandos en mΓ‘quinas remotas vΓa SSH usando clave SSH
Inputs: command (required), host (required), user (required), keyPath.
ssh_keyscanC
Obtener fingerprint de claves SSH de un host
Inputs: host (required).
ssh_scanC
Escanear red para encontrar hosts SSH disponibles
Inputs: network (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: powershell_execute is for local PowerShell commands, ssh_execute is for remote SSH command execution, ssh_keyscan retrieves SSH key fingerprints, and ssh_scan discovers SSH hosts on a network. There is no overlap or ambiguity between these functions.
All tool names follow a consistent snake_case pattern with a clear verb_noun structure: powershell_execute, ssh_execute, ssh_keyscan, ssh_scan. The naming is uniform and predictable across all tools.
With 4 tools, the count is reasonable for an SSH/PowerShell server, covering core remote execution and SSH management tasks. It might be slightly thin for advanced scenarios (e.g., missing file transfer or session management), but it's well-scoped for basic operations.
The toolset covers key SSH and PowerShell operations: remote command execution, host discovery, and key verification. Minor gaps exist, such as no file transfer (e.g., SCP/SFTP) or SSH configuration management, but agents can work around these with the provided tools for most workflows.
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Secure AI access to Windows, macOS, Linux computers and a hosted Cloud Browser.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables SSH remote access to servers through Claude, allowing users to execute commands, transfer files via SFTP, and manage multiple remote connections using natural language.129MIT
- FlicenseAqualityDmaintenanceEnables secure remote SSH command execution with strict read-only enforcement, allowing safe delegation of SSH access to Claude while preventing write operations. Supports connection pooling, command validation, and comprehensive logging for audit trails.51-
- AlicenseAqualityCmaintenanceSSH/SFTP server enabling remote command execution and secure file transfers, with integration for Claude AI.1816 npm2MIT
- -licenseNot gradedqualityNot gradedmaintenanceEnables Claude Code to control remote servers via SSH for automated deployment, testing, and operations, including command execution and file transfer.4-