Ferramentas de IA

O LikeC4 oferece duas ferramentas complementares de desenvolvimento assistido por IA: Agent Skills, para ensinar a DSL aos assistentes de IA, e um servidor MCP, para consultar o modelo de arquitetura.

Skills de agentes

As skills de agentes são referências da DSL carregadas automaticamente por assistentes de programação com IA ao editar arquivos .c4/.likec4. Elas ensinam a sintaxe, os padrões e os fluxos de validação do LikeC4 para que os agentes escrevam código DSL sem inventar construções inexistentes.

Instalar em qualquer projeto

npx skills add https://likec4.dev/

A instalação utiliza o protocolo Agent Skills Discovery. Skills disponíveis:

Skill	Descrição
`likec4-dsl`	Referência completa da DSL: especificação, modelo, visões, implantação, predicados e exemplos

Compatível com Claude Code, Cursor, Windsurf e outros agentes que oferecem suporte ao protocolo.

Servidor MCP

O servidor MCP do LikeC4 disponibiliza informações do modelo para modelos de linguagem (LLMs). Isso permite consultar o modelo em linguagem natural:

“Consulte o modelo LikeC4 e liste todos os relacionamentos de entrada da API de backend”

“Quais elementos aninhados do ‘Backend’ possuem relacionamentos com a API legada”

“List all elements tagged legacy from team1 project”

“Quais tecnologias são usadas na interface (considere todos os elementos com forma de navegador)”

“Export to CSV all relationships between Backend and Amazon SQS”

Como usar

Há três opções:

Utilizar o servidor MCP integrado à extensão
Utilizar o comando likec4 mcp da CLI
Utilizar o pacote @likec4/mcp

Pela extensão

Quando a extensão do LikeC4 está instalada no VS Code, o servidor MCP é registrado automaticamente pelo suporte nativo ao protocolo MCP (transporte stdio). Não é necessária configuração adicional: o servidor aparecerá na lista de servidores MCP quando a extensão estiver ativa.

Em outros editores, inicie o servidor MCP pela CLI e configure-o manualmente:

Crie .cursor/mcp.json:

{
  "mcpServers": {
    "likec4": {
      "url": "http://localhost:33335/mcp"
    }
  }
}

Depois, inicie o servidor: likec4 mcp --http

Consulte a documentação do Windsurf para saber mais:

{
  "mcpServers": {
    "likec4": {
      "serverUrl": "http://localhost:33335/mcp"
    }
  }
}

Depois, inicie o servidor: likec4 mcp --http

Adicione o servidor MCP ao Claude Code:

claude mcp add likec4 -- npx -y @likec4/mcp

Ou adicione-o a .mcp.json:

{
  "mcpServers": {
    "likec4": {
      "command": "npx",
      "args": ["-y", "@likec4/mcp"]
    }
  }
}

Pela CLI

Se a CLI likec4 estiver instalada, inicie o servidor MCP com transporte stdio:

likec4 mcp
# or
likec4 mcp --stdio

Inicie o servidor MCP com transporte http na porta 33335 (padrão), na pasta ./src:

likec4 mcp --http ./src

Inicie o servidor MCP com transporte http na porta 1234:

likec4 mcp -p 1234

Pelo pacote `@likec4/mcp`

Exemplo de configuração:

{
  "mcpServers": {
    "likec4": {
      "command": "npx",
      "args": [
        "-y",
        "@likec4/mcp"
      ],
      "env": {
        "LIKEC4_WORKSPACE": "${workspaceFolder}"
      }
    }
  }
}

Esse pacote inicia o servidor MCP usando o transporte stdio.

Se LIKEC4_WORKSPACE não estiver definida, o diretório atual será utilizado como workspace.

Você também pode utilizar o pacote @likec4/mcp como CLI (ele é menor que likec4):

npm install -g @likec4/mcp

# Start MCP server with streamable http transport
likec4-mcp --http --port 1234 /path/to/workspace

# See available options
likec4-mcp -h

Se o workspace for estático, desative o monitoramento com --no-watch para reduzir o consumo de recursos.

Ferramentas disponíveis

Ferramenta	Descrição
`list-projects`	Lista todos os projetos LikeC4 do workspace
`read-project-summary`	Especificação, configuração, elementos, nós de implantação e visões do projeto
`search-element`	Pesquisa elementos e nós de implantação por ID, título, tipo, forma, tags ou metadados
`read-element`	Detalhes do elemento, incluindo relacionamentos, visões, implantações e metadados
`read-deployment`	Detalhes de um nó de implantação ou de uma instância implantada
`read-view`	Detalhes da visão (nós/arestas) e localização no código-fonte
`render-view`	Renderiza uma visão salva como diagrama interativo (mover/ampliar/ajustar) no chat, para clientes compatíveis com MCP Apps
`preview-view`	Gera uma pré-visualização de uma visão a partir de texto DSL, sem salvar arquivos, para elaborar e aperfeiçoar diagramas no chat
`find-relationships`	Relacionamentos diretos e indiretos entre dois elementos
`query-graph`	Consulta a hierarquia (ancestrais, descendentes, irmãos, filhos e pai) e relacionamentos diretos de entrada e saída
`query-incomers-graph`	Grafo BFS recursivo das dependências/produtores a montante
`query-outgoers-graph`	Grafo BFS recursivo dos consumidores/dependentes a jusante
`query-by-metadata`	Pesquisa elementos por chave-valor de metadados (exato/contém/existe)
`query-by-tags`	Filtragem de tags com lógica booleana (allOf, anyOf, noneOf)
`query-by-tag-pattern`	Pesquisa elementos por padrões de tags usando prefixo, conteúdo ou sufixo
`find-relationship-paths`	Descobre cadeias de relacionamentos entre dois elementos por BFS
`batch-read-elements`	Obtém resumos de vários elementos, incluindo links e localização no código-fonte
`subgraph-summary`	Resume descendentes com profundidade, metadados e contagem de relacionamentos
`element-diff`	Compara elementos e mostra diferenças em propriedades, tags, metadados e relacionamentos
`open-view`	Abre o painel de visão do LikeC4 (somente no editor)

Consulte o README para saber mais.