convez.ai
MCP ServerDevOps & InfraestruturaAvançado
globulario

Globular Services

globulario/services

Plataforma distribuída gRPC-nativa com orchestração por IA para clusters self-hosted

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma de microsserviços open-source para aplicações distribuídas auto-hospedadas. Construída em gRPC com Protocol Buffers, opera via um modelo de estado explícito de 4 camadas (Repository → Desired → Installed → Runtime) e inclui servidor MCP com 129+ ferramentas para operação assistida por IA.

Instalação

$npx convez-ai globulario/services

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
1
Saúde
37%
Último commit
há 2 meses
Versão
v1.2.266
Issues abertas
1
Contribuidores
1

Casos de uso

  • Implantar e operar clusters de microsserviços distribuídos
  • Orquestração de fluxos de trabalho centralizados com convergência de estado
  • Diagnóstico e auto-cura de clusters via AI operators
  • Gerenciamento de pacotes, backups e DNS em ambientes distribuídos
  • Integração com agentes Claude via MCP para operações autônomas

Veredito

Projeto maduro e ambicioso para quem precisa de infraestrutura distribuída real com operação assistida por IA. Requer expertise em sistemas distribuídos, gRPC e Go; ideal para times que buscam alternativa opensource a Kubernetes com integração nativa a agentes Claude.

README

A tradução para o português deste README ainda está na fila.

Globular Services

Microservices platform for self-hosted distributed applications. Built on gRPC with Protocol Buffers, running as native Linux binaries under systemd. etcd as the single source of truth. Workflow-driven convergence across a 4-layer state model (Repository → Desired → Installed → Runtime).

Architecture

Proto definitions (proto/)
    ↓ generateCode.sh
Go services (golang/) + TypeScript clients (typescript/)
    ↓ build-all-packages.sh
Package archives (.tgz)
    ↓ globular-installer
Running cluster (systemd + etcd + Envoy)

Repository Structure

services/
├── proto/                     # 38 Protocol Buffer definitions (source of truth)
├── golang/                    # All Go microservices (33 services + CLI + MCP)
│   ├── cluster_controller/    # Cluster management, desired state, workflows
│   ├── node_agent/            # Node-local executor, package management
│   ├── workflow/              # Centralized workflow execution engine
│   ├── repository/            # Package artifact registry (MinIO-backed)
│   ├── authentication/        # JWT token management
│   ├── rbac/                  # Role-based access control
│   ├── dns/                   # Authoritative DNS + zone management
│   ├── monitoring/            # Prometheus adapter
│   ├── backup_manager/        # Distributed backup orchestration
│   ├── cluster_doctor/        # Health analysis + auto-heal
│   ├── ai_memory/             # Persistent AI knowledge (ScyllaDB)
│   ├── ai_executor/           # AI diagnosis + remediation
│   ├── ai_watcher/            # Event-driven incident detection
│   ├── ai_router/             # Dynamic routing policies
│   ├── compute/               # Distributed batch job execution
│   ├── domain/                # External domain + ACME cert management
│   ├── globularcli/           # CLI tool
│   ├── mcp/                   # Model Context Protocol server (129+ tools)
│   ├── globular_service/      # Shared service primitives
│   ├── globular_client/       # Shared client primitives
│   ├── interceptors/          # gRPC auth, RBAC, audit middleware
│   ├── config/                # etcd-backed configuration
│   ├── security/              # TLS, PKI, JWT, Ed25519 keystore
│   └── ...                    # 15+ additional services
├── typescript/                # TypeScript gRPC-Web client library
├── generated/                 # Generated specs, packages, policies
├── generateCode.sh            # Proto → Go/TypeScript code generation
└── build-all-packages.sh      # Full package build pipeline

Quick Start

Build from Source

# Requires: Go 1.24+, protoc, protoc-gen-go

# Generate code and build all services
bash generateCode.sh

# Build all packages (infrastructure + services)
bash build-all-packages.sh

Run Tests

cd golang
go test ./... -race

Build a Specific Service

cd golang
go build ./echo/echo_server

Services

Control Plane

ServicePortDescription
Cluster Controller12000Cluster management, desired state, membership, workflow dispatch
Node Agent11000Local executor, package tracking, service control
Workflow Service10004Centralized workflow execution and tracking
Cluster Doctor12005Health analysis, drift detection, auto-heal

Infrastructure

ServicePortDescription
etcd2379/2380Distributed configuration and state store
MinIO9000Object storage (packages, backups, artifacts)
Envoy Gateway443/8443TLS termination, xDS routing, gRPC-Web
Prometheus9090Metrics collection
Alertmanager9093Alert routing
ScyllaDB9042High-throughput data (AI memory, DNS storage)

Core Services

ServicePortDescription
Authentication10101JWT tokens, password management
RBAC10104Permission enforcement
Event10102Publish-subscribe event bus
File10103File management
DNS10006Authoritative DNS, zone management
Discovery10029Service discovery, install plans
Repository—Package artifact registry
Resource—Package descriptors, accounts, groups
Log10100Centralized logging

AI Services

ServicePortDescription
AI Memory10200Persistent knowledge store (ScyllaDB)
AI Watcher10210Event monitoring, incident detection
AI Router10220Dynamic routing policy computation
AI Executor10230Incident diagnosis and remediation

Operational

ServicePortDescription
Monitoring10019Prometheus API adapter
Backup Manager10040Backup orchestration
MCP Server10260AI agent interface (129+ diagnostic tools)
Domain Reconciler—External domain + ACME cert management (runs in controller)

Application Services

ServiceDescription
PersistenceMongoDB access layer
StorageKey-value store (BadgerDB)
SearchFull-text search (Bleve)
MediaAudio/video management
TitleMetadata service
MailSMTP email
LDAPLDAP authentication provider
SQLSQL database access
BlogCMS engine
ConversationChat management
CatalogComponent catalog
TorrentTorrent downloads

Documentation

Full documentation is in docs/:

Key Design Principles

  • etcd is the single source of truth — no environment variables, no hardcoded addresses
  • Workflow-driven convergence — all state changes go through the workflow engine
  • 4-layer state model — Repository → Desired → Installed → Runtime (never collapsed)
  • Native binaries under systemd — no containers required
  • Local-first — services run standalone with go run, no cluster needed for development

License

See LICENSE for details.

Ver o original no GitHub

Bom para