Sammy Farida 7cdfffd9ed fix: Resolve GitHub Actions wiki sync issues
- 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!
2025-10-25 22:51:36 -04:00
2025-10-21 14:42:10 -04:00

mcp-ssh-orchestrator

MCP SSH Orchestrator Logo

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.

License MCP Python

🚀 Quick Start

# 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

📖 Complete Documentation Wiki

🔒 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"}}

See complete Tools Reference

🤝 Contributing

See Contributing Guide for development setup.

📄 License

Apache 2.0 - See LICENSE for details.

Languages
Python 97.4%
Shell 2.3%
Dockerfile 0.3%