Claude Server Control Plugin

Claude Server Control Plugin

Control any computer remotely from Claude - Linux, macOS, or Windows - using natural conversation.

Run commands, manage services, deploy code, monitor health, edit files - all through Claude, without touching a terminal yourself.

---

Install - one command

Linux or macOS:

bash  "What's the CPU and memory usage?"

> "Restart nginx"

> "Show me the last 50 lines of the app log"

> "Is the database running?"

> "Deploy the latest version from git"

> "What docker containers are running?"

> "Find all files larger than 1GB"

> "What's in the Windows Event Log - any errors in the last hour?"

---

## Security

This plugin gives Claude SSH access to your machine. A few things to keep in mind:

- **Use Tailscale** - don't expose port 22 to the public internet
- **Use SSH key auth** instead of passwords for better security:
  ```bash
  ssh-keygen -t ed25519 -C "claude-plugin"
  ssh-copy-id user@YOUR_IP
  ```
  Then edit `SKILL.md` and replace the password line with `key_filename='/path/to/key'`
- **Keep the plugin folder private** - it contains your credentials after install
- **Never push your filled-in SKILL.md** to a public repo

---

## File structure

claude-server-control-plugin/ ├── install.sh # Linux/Mac one-liner installer ├── install.ps1 # Windows one-liner installer ├── .claude-plugin/ │ └── plugin.json ├── skills/ │ └── server-control/ │ ├── SKILL.md # Active skill (filled in by installer) │ ├── SKILL-mac.md # macOS version │ └── SKILL-windows.md # Windows version ├── setup/ │ ├── setup-linux.sh # Run on the remote Linux machine │ ├── setup-mac.sh # Run on the remote Mac │ └── setup-windows.ps1 # Run on the remote Windows machine (as Admin) ├── .mcp.json ├── .gitignore └── README.md

---

## Troubleshooting

**Can't connect:**
- Is Tailscale running on both machines? Run `tailscale status`
- Is SSH running? Linux: `systemctl status ssh` / Mac: System Settings -> Sharing -> Remote Login / Windows: `Get-Service sshd`
- Test manually from your terminal: `ssh YOUR_USERNAME@YOUR_IP`

**Wrong credentials after install:**
- Re-run the installer - it updates SKILL.md for you
- Or edit `skills/server-control/SKILL.md` directly

**Windows: Claude is using CMD instead of PowerShell:**
- Re-run `setup/setup-windows.ps1` as Administrator

---

## License

MIT - fork it, adapt it, make it yours.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [d0raka](https://github.com/d0raka)
- **Source:** [d0raka/claude-server-control-plugin](https://github.com/d0raka/claude-server-control-plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.