convez.ai
MCP ServerDevOps & InfraestruturaAvançado
joeyen-atscale

MCP Cluster Registry

joeyen-atscale/mcp-cluster-registry

Registro tipado multi-cluster para federação AtScale com roteamento inteligente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que gerencia um registro tipado de múltiplos endpoints AtScale com autenticação por cluster (direta/OIDC), capacidades, prioridades e filtros de modelos. Fornece parsing e validação de configurações TOML/JSON sem armazenar credenciais e sem operações assíncronas.

Instalação

$npx convez-ai joeyen-atscale/mcp-cluster-registry

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
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Configurar múltiplos endpoints de cluster com autenticação heterogênea
  • Rotear requisições para o cluster de maior prioridade com suporte ao backend necessário
  • Validar e filtrar clusters por modelo de dados suportado

Veredito

Ferramenta especializada para arquiteturas de federação AtScale em Rust. Executa validação rigorosa sem I/O de rede, adequada para ambientes corporativos que precisam de roteamento inteligente entre múltiplos clusters com segurança de credenciais.

README

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

mcp-cluster-registry

Typed TOML/JSON multi-cluster configuration registry for the AtScale federation gateway.

TL;DR

mqo-auth-bridge's LiveExecutor holds exactly one endpoint + one auth config. The federation gateway needs N of these, each with its own name, capabilities, and priority. This library defines the typed TOML/JSON config schema for a multi-cluster registry and provides the ClusterRegistry type that every downstream federation tool consumes — the mqo-spec of the federation fleet.

Usage

# Cargo.toml
[dependencies]
mcp-cluster-registry = { git = "https://github.com/joeyen-atscale/mcp-cluster-registry" }
use mcp_cluster_registry::ClusterRegistry;

let toml = std::fs::read_to_string("clusters.toml").unwrap();
let registry = ClusterRegistry::from_toml(&toml).unwrap();
registry.validate().unwrap();

// Route to the highest-priority required cluster
let primary = registry.primary_cluster().unwrap();

// Check backend support before routing
if registry.supports_backend("prod", "sql") {
    // ...
}

// Filter clusters by model
let clusters = registry.clusters_for_model("tpcds_benchmark_model");

Example clusters.toml

[[clusters]]
name = "prod"
endpoint = "mcp-aws.atscaleinternal.com:15432"
supported_backends = ["sql"]
priority = 0
required = true
tags = ["prod", "snowflake"]

[clusters.auth]
type = "direct"
pg_user = "atscale_user"
pg_pass_env = "PROD_PG_PASS"

[[clusters]]
name = "staging"
endpoint = "mcp-staging.atscaleinternal.com:15432"
xmla_url = "http://mcp-staging.atscaleinternal.com:11111"
supported_backends = ["sql", "dax", "mdx"]
priority = 1
required = false
model_filter = ["tpcds_benchmark_model"]

[clusters.auth]
type = "oidc"
token_url = "https://mcp-staging.atscaleinternal.com/auth/realms/AtScale/protocol/openid-connect/token"
client_id = "atscale-mcp"
realm = "AtScale"
client_secret_env = "STAGING_OIDC_SECRET"

Key design constraints

  • No credentials stored: AuthConfig stores only env-var names. The serializer never calls std::env::var(). AC7 is enforced by tests.
  • No network, no async: pure in-memory parsing and validation.
  • TOML for authoring, JSON for machine consumption: from_toml() / from_json() / to_json() all produce the same in-memory type.

API

// Parse
ClusterRegistry::from_toml(s: &str) -> Result<Self, RegistryError>
ClusterRegistry::from_json(s: &str) -> Result<Self, RegistryError>

// Serialize
ClusterRegistry::to_json(&self) -> String

// Query
ClusterRegistry::get(&self, name: &str) -> Option<&ClusterEntry>
ClusterRegistry::by_priority(&self) -> Vec<&ClusterEntry>
ClusterRegistry::supports_backend(&self, cluster: &str, backend: &str) -> bool
ClusterRegistry::clusters_for_model(&self, model_name: &str) -> Vec<&ClusterEntry>
ClusterRegistry::primary_cluster(&self) -> Option<&ClusterEntry>

// Validate
ClusterRegistry::validate(&self) -> Result<(), Vec<RegistryError>>

License

MIT OR Apache-2.0

Ver o original no GitHub

Bom para

Relacionados