Sammy Farida ac562b209e fix: move permissions to job level in scorecard workflow
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.
2025-10-26 17:36:09 -04:00
2025-10-25 23:45:48 -04:00
2025-10-21 14:42:10 -04:00
2025-10-26 00:23:37 -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 Docker OpenSSF Scorecard GitHub release GitHub stars GitHub issues GitHub contributors GitHub last commit GitHub Actions GitHub forks

🚀 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 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

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%