@semacode/mcp

@semacode/mcp expoe a Sema como servidor MCP para Claude Code, Cursor, VS Code, Cline e clientes compativeis.

Ele usa a CLI da Sema como backend operacional. Instale a CLI antes ou junto:

npm install -g @semacode/cli @semacode/mcp

Tambem funciona sem instalacao previa da ferramenta MCP:

npx -y @semacode/mcp

Ferramentas expostas

• sema_validar
• sema_ir
• sema_drift
• sema_impacto
• sema_renomear_semantico
• sema_resumo
• sema_prompt_ia
• sema_contexto_ia
• sema_sync_ai_entrypoints
• sema_instalar_exemplos
• sema_docs_impacto
• sema_finalizar_mudanca
• sema_verificar
• sema_inspecionar

Essas ferramentas acompanham a linha publica atual da Sema, incluindo persistencia vendor-first para postgres, mysql, sqlite, mongodb e redis.

sema_docs_impacto e sema_finalizar_mudanca formam o portao documental: a IA declara a intencao, recebe docs obrigatorias com conteudo para leitura, cria docs ausentes quando autorizado e fica impedida de concluir sem comprovar leitura.

Configuracao no Claude Code

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

Configuracao no Cursor, VS Code ou Cline

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

Rodando localmente pelo repo

{
  "mcpServers": {
    "sema": {
      "command": "node",
      "args": ["C:/GitHub/Sema/pacotes/mcp/dist/index.js"]
    }
  }
}

Modo stdio e modo HTTP

• padrao: stdio, ideal para uso local com agentes
• remoto: defina MCP_PORT para expor /mcp e /sse

Exemplo:

MCP_PORT=3333 npx -y @semacode/mcp

Observacoes

• o servidor MCP resolve sema pelo PATH do sistema
• sema_sync_ai_entrypoints tambem materializa exemplos/ oficiais sem sobrescrever arquivos existentes
• sema_docs_impacto deve ser chamado antes de operacoes como deploy, criacao de rota, mudanca de auth, banco, MCP ou extensao
• sema_finalizar_mudanca deve ser chamado antes da resposta final da IA quando a mudanca envolveu docs obrigatorias
• sema_verificar usa o diretorio do projeto informado como cwd, evitando escrever artefatos no lugar errado
• para reproduzibilidade, mantenha @semacode/cli e @semacode/mcp na mesma versao