mirror of
https://github.com/samerfarida/mcp-ssh-orchestrator.git
synced 2026-11-20 12:23:31 +00:00
7cdfffd9ed0599ed1130cdeb4140ba79dff536b3
- Fix rsync command to preserve .git directory - Add manual wiki sync script for testing - Improve error handling and debugging - Add comprehensive troubleshooting guide - Ensure proper branch handling (master for wikis) Manual sync successful: All 16 wiki sections now live!
mcp-ssh-orchestrator
A secure SSH fleet orchestrator built as a Model Context Protocol (MCP) server
Execute commands across your server fleet with policy-based access control, network filtering, and comprehensive audit logging.
🚀 Quick Start
Using Docker (Recommended)
# Pull the image
docker pull ghcr.io/samerfarida/mcp-ssh-orchestrator:0.1.0
# Run interactively
docker run -i --rm \
-v ~/mcp-ssh/config:/app/config:ro \
-v ~/mcp-ssh/keys:/app/keys:ro \
ghcr.io/samerfarida/mcp-ssh-orchestrator:0.1.0
📚 Documentation
- Architecture - Component design and data flow
- Security Model - Defense-in-depth security
- Configuration - servers.yml, credentials.yml, policy.yml
- Usage Cookbook - Practical examples
- Deployment - Production setup
🔒 Security Features
- Policy-Based Access Control: Fine-grained command allow/deny rules
- Network Security: IP allowlists with CIDR support
- Containerized Execution: Runs in containers with resource limits
- Audit Logging: JSON audit trail for all operations
- MCP Security Best Practices: Implements Docker MCP Gateway principles
🛠️ MCP Tools
| Tool | Purpose | Example |
|---|---|---|
ssh_ping |
Health check | {"name": "ssh_ping"} |
ssh_run |
Execute command | {"name": "ssh_run", "arguments": {"alias": "web1", "command": "uptime"}} |
ssh_run_on_tag |
Bulk operations | {"name": "ssh_run_on_tag", "arguments": {"tag": "prod", "command": "uptime"}} |
🤝 Contributing
See Contributing Guide for development setup.
📄 License
Apache 2.0 - See LICENSE for details.
🔗 Links
Description
No description provided
ai-agentsautomationclaudecursordockermcpmcp-servernetwork-controlpythonsecurity-policyserver-managementssh
Readme
Apache-2.0
17 MiB
Languages
Python
97.4%
Shell
2.3%
Dockerfile
0.3%