Roamer MCP

Ferramenta de fluxo de trabalho nativa de IA e spec-first: registro de projetos, especificações comportamentais e threads de engenharia via MCP

GitHubExperimente este MCPPatrocinado

Documentação

roamer-mcp-plugin

Plugin distribuível do Claude Code para o RoamerMcp — o servidor MCP do registro de projetos Roamer, banco de dados de especificações comportamentais e threads de engenharia. Saiba mais em roamermcp.mathismeadows.com.

Instalar este plugin oferece seis fluxos de trabalho baseados nas mesmas ferramentas que o RoamerMcp expõe via MCP. Cada um é um comando de barra, mas o Claude também pode invocá-lo por conta própria quando a conversa pedir — você não precisa digitar o comando manualmente:

  • /roamer:orient — briefing de início de sessão (registro de projetos + threads abertas)
  • /roamer:breadcrumb — checkpoint de fim de sessão (atualizações de registro + threads)
  • /roamer:feature — fluxo de trabalho de funcionalidade em sete etapas com portões
  • /roamer:bug — fluxo de trabalho de correção de bug em oito etapas com portões
  • /roamer:spec-audit — auditoria de cobertura de especificações
  • /roamer:spec-check — checklist de higiene

Instalação

/plugin marketplace add mathismeadows/roamer-mcp-plugin
/plugin install roamer@roamer

No primeiro uso, o Claude Code solicitará que você autentique contra o endpoint hospedado do RoamerMcp (login Entra ID por usuário via OAuth) — nenhuma configuração manual de token é necessária.

Status

Este repositório é público — instale diretamente com os comandos acima. Novas contas são provisionadas automaticamente no primeiro login, mas atualmente precisam de aprovação manual antes de poderem usar as ferramentas do RoamerMcp (um portão de acesso beta); você será notificado quando a sua for ativada.

Estrutura

  • .claude-plugin/plugin.json — manifesto do plugin
  • .claude-plugin/marketplace.json — entrada de marketplace autorreferente
  • .mcp.json — inicia scripts/roamer-bridge.sh via ${CLAUDE_PLUGIN_ROOT}
  • scripts/ — a mesma ponte stdio local (autentica contra o próprio servidor OAuth do RoamerMcp — um fluxo de código de dispositivo para máquinas com Safari padrão, um redirecionamento de loopback mais leve para todo o resto — via o pacote npm publicado @mathismeadows/roamer-device-auth, invocado via npx) usada pela própria configuração de desenvolvimento do RoamerMcp
  • skills/ — os seis comandos de fluxo de trabalho acima

Este repositório é apenas para distribuição — não possui código de servidor, testes ou relação com a arquitetura interna do RoamerMcp além de consumir seu endpoint MCP público.