# rml-mcp-code-style

Conector MCP que entrega um padrão de código para assistentes de IA (Claude, GitHub Copilot e qualquer cliente MCP). O padrão fica em arquivos Markdown, fora dos repositórios dos projetos, e roda de graça no Cloudflare Workers.

## O que o conector expõe

| Tipo | Nome | Para que serve |
|---|---|---|
| Ferramenta | `listar_padroes` | Lista os padrões disponíveis |
| Ferramenta | `obter_padrao` | Devolve o texto completo de um padrão (os de linguagem já incluem as regras gerais) |
| Prompt | `ajustar-no-padrao` | Aplica o padrão em um arquivo ou pasta, sem alterar comportamento |

Padrões incluídos: `geral`, `typescript-angular`, `exemplo-componente-angular` e `java`.

## Usar o seu próprio padrão

1. Faça um fork deste repositório.
2. Edite os arquivos em `padroes/`. Para criar um padrão novo, adicione o `.md` e registre-o em `src/padroes.ts`.
3. Publique (veja abaixo) e adicione a URL no seu assistente.

## Rodar localmente

```bash
npm install
npm run dev
npm test
```

`npm run dev` sobe o conector em `http://localhost:8787/mcp`. `npm test` chama esse endereço e confere as ferramentas; para testar o conector publicado, passe a URL: `npm test -- https://<seu-worker>.workers.dev/mcp`.

## Publicar no Cloudflare Workers

Pelo painel, sem token:

1. Suba o repositório para o GitHub.
2. No painel do Cloudflare, abra **Workers & Pages**, crie um Worker e escolha importar um repositório do GitHub.
3. Selecione este repositório e mantenha o comando de deploy `npx wrangler deploy`.

A cada push na branch principal o Cloudflare publica de novo.

Pela linha de comando:

```bash
npx wrangler login
npm run deploy
```

A URL do conector é `https://rml-mcp-code-style.<sua-conta>.workers.dev/mcp`.

## Conectar

- **Claude**: em Conectores, adicione um conector personalizado com a URL acima.
- **VS Code / GitHub Copilot**: adicione em `mcp.json`:

```json
{
  "servers": {
    "rml-code-style": { "type": "http", "url": "https://rml-mcp-code-style.<sua-conta>.workers.dev/mcp" }
  }
}
```

## Acesso

O conector é público e somente leitura: qualquer pessoa com a URL consegue ler os padrões. Não coloque nada confidencial em `padroes/`.

## Licença

MIT