Agent skill
vps
Direct VPS operations via SSH MCP. Manage Docker containers, check logs, run commands, and troubleshoot services on registered VPS servers.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/vps
SKILL.md
VPS Operations Skill
Direct SSH access to VPS servers for container management and troubleshooting.
Usage
/vps # Show VPS status for current project
/vps status # Container status + resource usage
/vps logs <service> # View service logs (tail -100)
/vps logs <service> --follow # Stream logs
/vps exec '<command>' # Execute arbitrary command on VPS
/vps restart <service> # Restart specific container
/vps health # Run health checks on all services
/vps resources # Show CPU, memory, disk usage
/vps backup # Backup database to NAS
Project Detection
Reads project from:
- Current git remote URL
deployments.registry.jsonlookup
Common Operations
Container Management
# List all containers
ssh ${USER}@${HOST} "docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'"
# Restart service
ssh ${USER}@${HOST} "docker compose -f ${COMPOSE_PATH} restart ${SERVICE}"
# View logs
ssh ${USER}@${HOST} "docker logs ${CONTAINER} --tail 100"
# Execute in container
ssh ${USER}@${HOST} "docker exec ${CONTAINER} npm run db:migrate"
Health Monitoring
# System resources
ssh ${USER}@${HOST} "free -h && df -h && uptime"
# Docker resource usage
ssh ${USER}@${HOST} "docker stats --no-stream"
# Nginx status
ssh ${USER}@${HOST} "sudo systemctl status nginx"
# Active connections
ssh ${USER}@${HOST} "netstat -an | grep ESTABLISHED | wc -l"
Database Operations
# Backup database
ssh ${USER}@${HOST} "docker exec ${DB_CONTAINER} pg_dump -U postgres ${DB} > /backup/${DB}_$(date +%Y%m%d).sql"
# Copy backup to NAS
scp ${USER}@${HOST}:/backup/${DB}_*.sql berry@10.0.0.23:/volume1/backups/
# Check database connections
ssh ${USER}@${HOST} "docker exec ${DB_CONTAINER} psql -U postgres -c 'SELECT count(*) FROM pg_stat_activity;'"
Troubleshooting
# Check for OOM kills
ssh ${USER}@${HOST} "dmesg | grep -i 'out of memory' | tail -10"
# Check docker events
ssh ${USER}@${HOST} "docker events --since '1h' --until 'now'"
# Check failed services
ssh ${USER}@${HOST} "docker ps -a --filter 'status=exited' --format '{{.Names}}: {{.Status}}'"
Safety
- NEVER run
pkill node- will kill Claude Code - NEVER run destructive commands without confirmation
- ALWAYS check what you're about to do with
--dry-runfirst - Use
docker compose restartinstead of killing containers
MCP Tool Reference
mcp__project-vps__exec # Execute commands on project VPS
mcp__home-nas__exec # Execute commands on home NAS
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?