MCP-HUB Documentation

Документация MCP-HUB

MCP-HUB Dokumentacija

Autonomous VM Management via Model Context Protocol

Автономное управление VM через Model Context Protocol

Autonominis VM valdymas per Model Context Protocol

🏗️ Architecture Архитектура Architektūra

+
📱 Mobile (Anthropic App) │ ▼ ┌─────────────────────────────────────┐ │ FLY.IO MCP SERVER (index.js) │ │ mcp-hub-old-frost-2327.fly.dev/mcp │ │ • 40+ MCP Tools │ │ • Streamable HTTP Transport │ └────────────────┬────────────────────┘ │ HTTP API ▼ ┌─────────────────────────────────────┐ │ VM2 (hub) - oracle-agent-api.js │ │ • Agent API on port 8080 │ │ • nginx reverse proxy │ │ • PM2 process manager │ └────────────────┬────────────────────┘ │ SSH ▼ ┌─────────────────────────────────────┐ │ VM1 (main) - grok-* services │ │ • systemd managed services │ └─────────────────────────────────────┘

🖥️ VM Configuration Конфигурация VM VM Konfigūracija

+

VM1 (main) ~28 services

92.5.72.169 • systemd

AGI Core:AGI Ядро:AGI Branduolys: grok-collective-mind, grok-shared-context, grok-heartbeat

Tasks:Задачи:Užduotys: grok-task-memory, grok-task-tracker

Communication:Коммуникация:Komunikacija: grok-telegram-bot

Monitoring:Мониторинг:Stebėjimas: grok-admin-api, grok-monitor, grok-recovery, grok-caddy-watchdog

AI Assistants:AI Ассистенты:AI Asistentai: grok-voice, grok-emilia, grok-android, grok-portal

Automation:Автоматизация:Automatizavimas: grok-auto-sync, grok-backup-scheduler

VM2 (hub) PM2 + nginx

158.180.56.74

oracle-agent-api, todo-api, mcp-hub-storage, transcriber, nginx

ai-learning-agent, auto-deployer, youtube-ai-monitor

🔧 MCP Tools (40+) MCP Инструменты (40+) MCP Įrankiai (40+)

+

📝 Notes/Tasks

CRUD operations stored on Oracle VM

CRUD операции на Oracle VM

CRUD operacijos Oracle VM

📂 GitHub

Repo/file management, backup/restore

Управление репозиториями и файлами

Repozitorijų ir failų valdymas

📁 VM Files

List, read, write, delete files on VMs

Чтение, запись, удаление файлов на VM

Skaityti, rašyti, trinti failus VM

⚙️ VM Services

Status, logs, start/stop/restart systemd

Статус, логи, запуск/остановка сервисов

Būsena, logai, paleisti/stabdyti

🐍 Code Execution

Run/check Python code on VMs

Выполнение Python кода на VM

Python kodo vykdymas VM

🩺 Diagnostics

Health checks, service mapping

Проверка здоровья, карта сервисов

Sveikatos tikrinimas

🎬 Transcriber

Video transcription with AI summary

Транскрибация видео с AI саммари

Video transkripcija su AI santrauka

💬 Telegram

Check/respond via Shared Brain

Проверка/ответ через Shared Brain

Tikrinti/atsakyti per Shared Brain

🔗 Key URLs Ключевые URL Pagrindiniai URL

+
Service Сервис Paslauga URL
MCP Endpoint mcp-hub-old-frost-2327.fly.dev/mcp
Shared Brain mcp-hub-old-frost-2327.fly.dev
AGI Hub hub.92-5-72-169.sslip.io
Task Memory tasks.92-5-72-169.sslip.io
Admin API http://92.5.72.169:5001

💻 Commands Команды Komandos

+
# Run locally
npm start

# Deploy to Fly.io
fly deploy

# View logs
fly logs -a mcp-hub-old-frost-2327

# SSH to Fly.io
fly ssh console

# Check Brain messages
curl -s https://mcp-hub-old-frost-2327.fly.dev/brain | jq '.conversation[-5:]'

# Send to Telegram
curl -X POST https://mcp-hub-old-frost-2327.fly.dev/telegram/say \
  -H "Content-Type: application/json" \
  -d '{"instance":"windows","message":"Hello!"}'

🤖 Autonomous Rules Автономные правила Autonominės taisyklės

+

✅ Allowed (no confirmation) ✅ Разрешено (без подтверждения) ✅ Leidžiama (be patvirtinimo)

  • Diagnostics - check service status, logs, disk/memory/cpu
  • Service restart - systemctl restart any service
  • Read files - any configs and code
  • Fix errors - auto-fix crashed services
  • Upload files - update code via SCP
  • Create services - new systemd units
  • Manage nginx - add/modify configs
  • Диагностика - проверка статуса, логов, диска/памяти
  • Рестарт сервисов - systemctl restart любого сервиса
  • Чтение файлов - любые конфиги и код
  • Исправление ошибок - автофикс упавших сервисов
  • Загрузка файлов - обновление кода через SCP
  • Создание сервисов - новые systemd юниты
  • Управление nginx - добавление/изменение конфигов
  • Diagnostika - tikrinti būseną, logus, diską/atmintį
  • Paslaugų perkrovimas - systemctl restart
  • Failų skaitymas - bet kokie konfigai ir kodas
  • Klaidų taisymas - auto-fix sugriuvusių paslaugų
  • Failų įkėlimas - kodo atnaujinimas per SCP
  • Paslaugų kūrimas - nauji systemd vienetai
  • nginx valdymas - konfigų pridėjimas

⚠️ Caution (do, but report) ⚠️ Осторожно (делать, но сообщать) ⚠️ Atsargiai (daryti, bet pranešti)

  • Delete files - backup first
  • Change ports - verify port is free
  • System update - apt upgrade only when necessary
  • Удаление файлов - сначала бэкап
  • Смена портов - проверить что порт свободен
  • Обновление системы - apt upgrade только при необходимости
  • Failų trynimas - pirma backup
  • Portų keitimas - tikrinti ar portas laisvas
  • Sistemos atnaujinimas - tik kai būtina

❌ Require Permission ❌ Требуется разрешение ❌ Reikia leidimo

  • Reboot VM
  • Delete services
  • Change SSH/firewall
  • Перезагрузка VM
  • Удаление сервисов
  • Изменение SSH/firewall
  • VM perkrovimas
  • Paslaugų trynimas
  • SSH/firewall keitimas

🎯 Agent Skills Навыки агента Agento įgūdžiai

+
Skill Description Описание Aprašymas
agi-architecture VISAGINAS360 Dual-Brain AGI system Система двойного мозга AGI Dviejų smegenų AGI sistema
oracle-vm Manage Oracle VMs - status, logs, restart Управление Oracle VM - статус, логи Oracle VM valdymas
telegram-auto Auto-monitor Telegram via Shared Brain Автомониторинг Telegram через Shared Brain Auto-stebėjimas per Shared Brain
transcribe Video transcription from YouTube/TikTok Транскрибация видео с YouTube/TikTok Video transkripcija iš YouTube/TikTok
deploy Deploy services to Oracle VMs Деплой сервисов на Oracle VM Paslaugų diegimas į Oracle VM
github-sync GitHub synchronization management Управление синхронизацией с GitHub GitHub sinchronizacijos valdymas
code-review Code review with MCP-HUB standards Код-ревью по стандартам MCP-HUB Kodo peržiūra pagal MCP-HUB standartus

🔧 Auto-Fix Procedures Процедуры автоисправления Automatinio taisymo procedūros

+

Service not running:

Сервис не работает:

Paslauga neveikia:

  1. Check logs: journalctl -u SERVICE -n 50
  2. Проверить логи: journalctl -u SERVICE -n 50
  3. Tikrinti logus: journalctl -u SERVICE -n 50
  4. Identify error (ImportError, missing file, port conflict)
  5. Определить ошибку (ImportError, нет файла, конфликт порта)
  6. Nustatyti klaidą (ImportError, trūksta failo, porto konfliktas)
  7. Fix the issue
  8. Исправить проблему
  9. Ištaisyti problemą
  10. Restart: sudo systemctl restart SERVICE
  11. Рестарт: sudo systemctl restart SERVICE
  12. Perkrauti: sudo systemctl restart SERVICE
  13. Verify: systemctl status SERVICE
  14. Проверить: systemctl status SERVICE
  15. Patikrinti: systemctl status SERVICE

Common Fixes:

Частые исправления:

Dažni taisymai:

  • EADDRINUSEfuser -k PORT/tcp
  • MODULE_NOT_FOUNDnpm install MODULE
  • ENOENT → Restore from backup or GitHub