convez.ai
MCP ServerDevOps & InfraestruturaAvançado
j0yen

muster-mcp

j0yen/muster-mcp

Inspeção de sessões Claude ao vivo via MCP, sem kill paths

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP read-only que expõe um censo de sessões Claude ao vivo, permitindo agentes consultar o estado da população de sessões com atribuição de origem e diagnóstico de saúde. Implementado em Rust, fornece visibilidade sobre sessões live, duplicadas, órfãs e obsoletas sem expor capacidades de terminação (que permanecem bloqueadas por design).

Instalação

$npx convez-ai j0yen/muster-mcp

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

  • Monitorar população de sessões Claude em tempo real
  • Diagnosticar sessões órfãs, duplicadas ou obsoletas
  • Auditoria e rastreamento de origem de sessões ativas
  • Debugging de problemas de sessão sem acesso a kill paths

Veredito

MCP server especializado e bem-arquitetado para inspeção de sessões com princípio de segurança claro (human-gated kill paths). Útil em ambientes Wintermute, mas nicho e dependente de `muster` binary disponível; documentação clara sobre o que *não* faz é um ponto forte.

README

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

muster-mcp

Live-session census as a read-only MCP server.

muster-mcp exposes two MCP tools that let any MCP-capable agent query the current wintermute session population — without exposing the kill path.

Tools

sessions_census

Enumerates live Claude sessions with origin attribution and bus reconciliation. Equivalent to running muster census --format json.

  • Input: no arguments (empty object {})
  • Output: JSON array of session objects with PID, origin, and bus state

sessions_verdict

Annotates the live-session census with live, duplicate, orphan, or stale verdicts plus supporting evidence. Equivalent to running muster verdict --format json.

  • Input: no arguments (empty object {})
  • Output: JSON array of session objects with verdict and evidence fields

Why reap is excluded

muster reap kills sessions. This server is an inspection surface only. Exposing reap over MCP would allow any connected agent to terminate sessions autonomously — which violates the principle that kill paths must remain human-gated. An agent using muster-mcp can see the roster but never act on it.

Usage

# Start the MCP server on stdio
muster-mcp serve

# Use a custom muster binary (also: MUSTER_BIN=/path/to/muster)
muster-mcp serve --muster-bin /usr/local/bin/muster

MCP client configuration

Add to your MCP client config (e.g. Claude Code .mcp.json):

{
  "mcpServers": {
    "muster": {
      "command": "muster-mcp",
      "args": ["serve"]
    }
  }
}

Or with a custom binary path:

{
  "mcpServers": {
    "muster": {
      "command": "muster-mcp",
      "args": ["serve", "--muster-bin", "/home/jsy/.local/bin/muster"]
    }
  }
}

Dependencies

  • muster binary must be on $PATH (or specified via --muster-bin / MUSTER_BIN)
  • mcp-core (path dependency, part of the wintermute workspace)

Building

cargo build --release
# Binary at: target/release/muster-mcp

License

MIT OR Apache-2.0 — Joe Yen

Ver o original no GitHub

Bom para

Relacionados