MCP - Padronização de Dados do Projeto

Este MCP garante que o modelo sempre siga a padronização de dados do projeto, evitando confusões em nomes de variáveis, tabelas e colunas do banco de dados.

🚀 Funcionalidades

🔍 Validação de Variáveis

• Verifica se nomes de variáveis seguem a convenção do projeto

• Suporta camelCase, snake_case e PascalCase

• Valida prefixos obrigatórios por tipo

• Identifica nomes proibidos

🗄️ Validação de Banco de Dados

• Valida nomes de tabelas e colunas

• Mantém registro da estrutura do banco

• Verifica consistência na nomenclatura

📁 Validação de Estrutura de Arquivos

• Valida nomes de arquivos e pastas

• Verifica extensões apropriadas

• Sugere melhorias na organização

💡 Sugestões Inteligentes

• Gera nomes de variáveis baseados em descrições

• Segue os padrões configurados do projeto

• Aplica prefixos automaticamente

Related MCP server: Project Content Server

📦 Instalação

1. Clone ou baixe os arquivos:

2. Instale as dependências:

3. Teste o MCP:

🛠️ Ferramentas Disponíveis

validate_variable_name

Valida se um nome de variável segue os padrões do projeto.

Parâmetros:

• variable_name (obrigatório): Nome da variável a ser validada

• variable_type (opcional): Tipo da variável para verificar prefixos

Exemplo:

validate_database_structure

Valida estrutura de tabelas e colunas do banco de dados.

Parâmetros:

• table_name (obrigatório): Nome da tabela

• columns (opcional): Lista de colunas da tabela

Exemplo:

set_project_standards

Define os padrões de nomenclatura do projeto.

Parâmetros:

• variable_naming: Padrão (camelCase, snake_case, PascalCase)

• forbidden_names: Lista de nomes proibidos

• required_prefixes: Prefixos obrigatórios por tipo

Exemplo:

get_project_standards

Retorna os padrões atuais do projeto.

suggest_variable_name

Sugere um nome de variável seguindo os padrões.

Parâmetros:

• description (obrigatório): Descrição do que a variável representa

• variable_type (opcional): Tipo da variável

Exemplo:

validate_file_structure

Valida a estrutura de arquivos e pastas do projeto.

Parâmetros:

• file_path (obrigatório): Caminho do arquivo a ser validado

⚙️ Configuração

Padrões Padrão

O MCP vem com configurações padrão que você pode personalizar:

• Convenção de variáveis: camelCase

• Nomes proibidos: data, temp, tmp, var, obj

• Prefixos obrigatórios:

  • boolean: is

  • function: handle

  • event: on

Personalização

Edite o arquivo config.json para personalizar os padrões:

🔧 Integração com Clientes MCP

Configuração do Cliente

Adicione ao seu cliente MCP:

Uso no Cursor/VS Code

1. Configure o MCP no seu cliente

2. Use as ferramentas diretamente no chat

3. O modelo automaticamente validará e sugerirá nomes

🧪 Testando

Demonstração Rápida

Testes Completos

Exemplo de Saída

🎯 Benefícios

1. Consistência: Garante que todos os nomes sigam o mesmo padrão

2. Prevenção de Erros: Evita confusões entre variáveis similares

3. Manutenibilidade: Código mais limpo e organizado

4. Produtividade: Sugestões automáticas de nomes

5. Documentação: Mantém registro da estrutura do projeto

🔄 Fluxo de Trabalho

1. Configure os padrões do seu projeto

2. Valide variáveis antes de usar

3. Use sugestões para nomes consistentes

4. Mantenha o banco organizado

5. Valide arquivos para estrutura limpa

🤝 Contribuição

Para adicionar novas funcionalidades ou melhorar o MCP:

1. Fork o projeto

2. Crie uma branch para sua feature

3. Implemente as mudanças

4. Teste as funcionalidades

5. Envie um pull request

📄 Licença

MIT License - veja o arquivo LICENSE para detalhes.

🆘 Suporte

Se encontrar problemas:

1. Verifique se todas as dependências estão instaladas

2. Execute python demo.py para testar

3. Consulte os exemplos em test_examples.py

4. Abra uma issue no repositório

🎉 Agora seu modelo sempre seguirá os padrões do projeto!