# mcp-vue3-python

Servidor MCP em Python que gera estrutura completa de CRUD Vue 3 (Composition
API).

## Instalação

```bash
cd mcp-vue3-python
pip install -r requirements.txt
```

## Configuração no Claude Desktop

Edite o arquivo `claude_desktop_config.json`:

**Windows:**

```
%APPDATA%\Claude\claude_desktop_config.json
```

**macOS / Linux:**

```
~/Library/Application Support/Claude/claude_desktop_config.json
```

### Conteúdo a adicionar:

```json
{
  "mcpServers": {
    "mcp-vue3-python": {
      "command": "python",
      "args": ["-m", "mcp_vue3.app"]
    }
  }
}
```

> **Windows com WSL/Docker:** use `python3` e ajuste o caminho conforme
> necessário.

## Uso

No Claude, digite:

```
Utilize a tool gerar_crud do mcp mcp-vue3-python para gerar toda a estrutura de
arquivos e código para o seguinte módulo: CtreProfissionais
```

Ou com caminho base customizado:

```
Utilize a tool gerar_crud do mcp mcp-vue3-python para gerar toda a estrutura de
arquivos e código para o módulo CtreProfissionais com base_path /meu-projeto/src/views/ctreProfissionais
```

## Arquivos gerados

Para o módulo `CtreProfissionais` com `base_path` padrão
`/projeto-vue3/src/views/ctreProfissionais`:

```
ctreProfissionais/
├── index.vue                         # Listagem com tabela e botões
├── services/
│   └── ctreProfissionaisService.js   # axios: table, edit, post, patch, delete
├── components/
│   └── CtreProfissionaisForm.vue     # Modal de criação/edição
├── store/
│   └── ctreProfissionaisStore.js     # Pinia store
├── routes.js                         # Fragmento para router/index.js
└── README.md                         # Documentação do módulo
```

## Regras

1. **Pastas existentes** são reaproveitadas (nunca recriadas do zero).
2. **Arquivos existentes** são preservados — o servidor reporta
   `⚠️ Já existe (mantido)` e não sobrescreve.
3. **Arquivos novos** são criados e reportados com `✅ Criado`.

## Nomenclatura automática

| Entrada (PascalCase) | Derivado   | Exemplo                 |
| -------------------- | ---------- | ----------------------- |
| `CtreProfissionais`  | kebab-case | `ctre-profissionais`    |
| `CtreProfissionais`  | camelCase  | `ctreProfissionais`     |
| `CtreProfissionais`  | snake_case | `ctre_profissionais`    |
| `CtreProfissionais`  | campo ID   | `id_ctre_profissionais` |
| `CtreProfissionais`  | rota base  | `/ctre-profissionais`   |