mirror of
https://github.com/samerfarida/mcp-ssh-orchestrator.git
synced 2026-11-20 20:33:16 +00:00
ac562b209ef7b25b3cf5bd21c62a87191c19ef80
Move permissions from workflow level to job level to comply with OpenSSF Scorecard action restrictions. According to documentation: - No workflow level write permissions allowed - Only the job with ossf/scorecard-action can use id-token: write - This ensures workflow passes validation for publishing results The badge and SARIF upload will now work correctly.
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 | Execution Type |
|---|---|---|
ssh_ping |
Health check | N/A |
ssh_list_hosts |
List all hosts | N/A |
ssh_describe_host |
Get host details | N/A |
ssh_plan |
Policy dry-run | N/A |
ssh_run |
Execute command | Synchronous |
ssh_run_on_tag |
Execute on tagged hosts | Synchronous |
ssh_run_async |
Start async task | Asynchronous |
ssh_get_task_status |
Check task progress | Async monitoring |
ssh_get_task_result |
Get task result | Async result |
ssh_get_task_output |
Stream task output | Async monitoring |
ssh_cancel |
Cancel sync task | Task control |
ssh_cancel_async_task |
Cancel async task | Async control |
ssh_reload_config |
Reload configuration | Management |
🤝 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%