SMOrchestra MCPs — server / ops / infrastructure

Give Claude full operational control of your servers. أعطِ Claude تحكمًا كاملًا في خوادمك.

A collection of Model Context Protocol servers for provisioning, SSH, monitoring, and the infrastructure layer beneath your apps. Plug them into Claude Desktop with your own credentials — Claude can then provision VPSes, SSH in, run commands, tail logs, inspect Docker, and more.

---

Scope

This repo holds server, ops, and infrastructure MCPs only:

• Provisioning (Contabo today; Cloudflare and Tailscale next)
• SSH + remote command execution + log reading + Docker / compose
• Monitoring stack templates (Prometheus / Grafana — future)

Sales / CRM / marketing MCPs (GoHighLevel, n8n wrappers, etc.) live in a separate repo so devops audiences and sales audiences each get a focused README.

If you want to contribute an MCP, see whether it's a server/ops/infrastructure surface — if yes, open a PR adding packages/<name>-mcp/. If it's a different domain, ask in an issue first.

---

Available MCPs

Package	npm	Tools	What it does
@smorchestraai-code/contabo-mcp	v1.0.0	57	Contabo VPS/VDS lifecycle — instances, DNS, snapshots, tags, networks, secrets, users, domains, images, PTR records, audits
@smorchestraai-code/ssh-mcp	v1.0.0	16	SSH into any server you have keys for — commands, file transfer, logs, Docker, ServerFast bundle credentials

Coming soon

• @smorchestraai-code/cloudflare-mcp — DNS + tunnels + pages
• @smorchestraai-code/tailscale-mcp — mesh network + ACLs
• @smorchestraai-code/monitoring-stack — Prometheus + Grafana docker-compose template (not an MCP — a scaffolder)

---

Install both — one Claude Desktop config

📘 Full step-by-step guides with screenshots-ready instructions for first-time setup, Contabo credential capture, SSH key generation, and a test prompt:

• Install on Windows — 10 minutes from a fresh machine
• Install on macOS — 10 minutes from a fresh machine
• Troubleshooting — common failures + fixes

Quick version (for experienced users)

You need: Node.js 20+ and Claude Desktop.

Open Claude Desktop → Settings → Developer → Edit Config (or find claude_desktop_config.json manually — see install guides for paths).

Paste this block (replace the four Contabo placeholders with credentials from my.contabo.com → Account → API):

{
  "mcpServers": {
    "contabo": {
      "command": "npx",
      "args": ["-y", "@smorchestraai-code/contabo-mcp"],
      "env": {
        "CONTABO_CLIENT_ID": "...",
        "CONTABO_CLIENT_SECRET": "...",
        "CONTABO_API_USER": "...",
        "CONTABO_API_PASSWORD": "..."
      }
    },
    "ssh": {
      "command": "npx",
      "args": ["-y", "@smorchestraai-code/ssh-mcp"]
    }
  }
}

Quit Claude Desktop fully (system tray quit / Cmd+Q) and reopen. The SSH MCP reads your SSH keys from ~/.ssh/ automatically — no env vars needed.

---

What you can ask Claude

Combining both MCPs makes provision → SSH → check workflows possible in one prompt:

• "Create a new V45 in Germany with Ubuntu 24.04 latest, then SSH in as root and tail /var/log/syslog"
• "List my snapshots, then for the newest one, SSH in and check docker ps"
• "Provision a server, then read the bundle credentials so I can log into n8n"

---

Development

This is a workspaces monorepo. Each MCP lives under packages/.

git clone https://github.com/SMOrchestra-ai/smorchestra-mcps.git
cd smorchestra-mcps
npm install                              # installs all package deps
npm run build --workspaces                # builds every package
npm test --workspaces                     # runs every test suite (~500 tests)
npm test --workspace=packages/ssh-mcp    # runs just one package

To release a new version: tag with the package prefix and push.

git tag ssh-v1.0.1 -m "ssh: handle ed25519-sk keys"
git push origin ssh-v1.0.1

The release workflow detects the prefix, runs that package's tests, and publishes to npm.

---

Contributing

PRs welcome for server / ops / infrastructure MCPs. Open an issue first if it's a new package — we'll confirm domain fit before you spend time. See CONTRIBUTING.md for the full guide (project conventions, release process, scope rules).

Each package has its own README + install docs + troubleshooting guide under packages/<name>/.

---

License

MIT — © 2026 SMOrchestra.ai / Mamoun Alamouri