SSH-based MCP server for the Helm build agent. Provides remote shell access and file operations on the Minisforum MS-A2 (Helm target host) via SSH, plus read-only local access to build plans and memory on claudebox.
| Tool | Purpose |
|---|---|
run_command |
Execute bash commands on the MS-A2 |
read_file |
Read files with optional line range |
write_file |
Write/overwrite files, auto-create parent dirs |
edit_file |
Find-and-replace (exact single match) |
read_directory |
List directory contents, optionally recursive |
upload_file |
SCP a file from claudebox to the MS-A2 |
| Tool | Purpose |
|---|---|
local_read_file |
Read build plans, memory, design docs |
local_read_directory |
List build plan and memory directories |
Local tools are restricted to an allowlist:
~/repos/personal/helm-platform/~/.claude/projects/helm-build/~/.claude/projects/research/build-plans/~/.claude/memory/~/repos/personal/claude-prime-directive/
Environment variables:
| Variable | Default | Description |
|---|---|---|
HELM_SSH_HOST |
(required) | MS-A2 hostname or IP |
HELM_SSH_USER |
ted |
SSH username |
HELM_SSH_KEY |
~/.ssh/id_ed25519 |
Path to SSH private key |
HELM_SSH_PORT |
22 |
SSH port |
HELM_SSH_TIMEOUT |
60 |
Default command timeout (seconds) |
# Direct
HELM_SSH_HOST=192.168.1.XX python3 server.py --port 8283
# PM2
HELM_SSH_HOST=192.168.1.XX pm2 start server.py --name helm-ops-mcp --interpreter python3 -- --port 8283
pm2 save- SSH key-based auth configured between claudebox and the MS-A2
- Python 3.10+ with
fastmcpinstalled - The MS-A2 must have Debian installed and SSH enabled
This server provides unrestricted shell access to the MS-A2 via SSH. It is designed for trusted, internal-only use by the helm-build Claude Code agent on claudebox. Do not expose to the network.