SSH-PowerShell MCP Server
Click on "Install 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 Serverrun '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
๏ฟฝ๐ 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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GUEPARD98/MCP-POWERSHELL'
If you have feedback or need assistance with the MCP directory API, please join our Discord server