MCPS-K - Model Context Protocol Servers# EBurguer v2 - Sistema de Pedidos
🔌 Configuração centralizada de servidores MCP (Model Context Protocol) para integração com VS Code e GitHub Copilot.Sistema completo de pedidos de hamburgueria com frontend React, backend Node.js/Express e infraestrutura AWS via Terraform.
📋 Sobre## 📁 Estrutura do Projeto
Este repositório contém a configuração automatizada de múltiplos servidores MCP que permitem ao GitHub Copilot acessar:```
EBURGUERV2/
- 🏗️ Terraform - Documentação atualizada de providers e módulos├── backend/ # API REST Node.js/Express
- 🐙 GitHub - Gerenciamento de repositórios, issues e PRs│ ├── models/ # Modelos MongoDB
- 🧠 Memory - Sistema de memória persistente│ ├── routes/ # Rotas da API
- 📁 Filesystem - Acesso seguro aos arquivos do projeto│ ├── index.js # Servidor principal
- 🔍 Brave Search - Busca web em tempo real│ └── .env # Variáveis de ambiente
├── frontend/ # Aplicação React
🚀 Quick Start│ ├── src/
│ │ ├── components/ # Componentes React
Pré-requisitos│ │ └── App.js # Componente principal
- Windows 10/11│ └── build/ # Build de produção
- PowerShell 5.1 ou superior├── terraform/ # Infraestrutura como código
- Node.js 16+ e npm│ ├── main.tf # Recursos AWS principais
- Git│ ├── variables.tf # Variáveis
- VS Code com GitHub Copilot│ ├── outputs.tf # Outputs
│ ├── deploy.ps1 # Script de deploy
Instalação Automática│ └── README.md # Documentação Terraform
└── .github/
# Clone o repositório```
git clone https://github.com/kcsdevops/MCPS-K.git
cd MCPS-K## 🚀 Como Executar Localmente
# Execute o deploy completo### Backend
.\deploy.ps1 -Action Install```powershell
.\deploy.ps1 -Action Validatecd backend
npm start
Configuração Manual# Servidor roda em http://localhost:5000
1. **Instale os MCPs**:
.\deploy.ps1 -Action Install```powershell
npm install
2. **Valide a configuração**:npm start
.\deploy.ps1 -Action Validate```
### MongoDB
3. **Reinicie o VS Code**- Instale MongoDB localmente ou use MongoDB Atlas
- Configure a string de conexão no arquivo `backend/.env`
4. **Configure o GitHub Copilot para modo Agent**
## ☁️ Deploy na AWS
## 📖 Comandos Disponíveis
### Pré-requisitos
Mostrar status do projeto2. Terraform >= 1.0 instalado
.\deploy.ps1 -Action Status3. Conta AWS com permissões necessárias
Instalar todos os MCPs### Deploy da Infraestrutura
.\deploy.ps1 -Action Install```powershell
cd terraform
Validar configuração# Configurar variáveis
.\deploy.ps1 -Action ValidateCopy-Item terraform.tfvars.example terraform.tfvars
Editar terraform.tfvars com seus valores
Fazer deploy e commit
.\deploy.ps1 -Action Deploy# Deploy
.\deploy.ps1 -Apply
Deploy com push automático```
.\deploy.ps1 -Action Deploy -Push
Upload do Site
Atualizar MCPs```powershell
.\deploy.ps1 -Action Update# Build do frontend
cd frontend
Criar backup da configuraçãonpm run build
.\deploy.ps1 -Action Backup
aws s3 sync build/ s3://BUCKET-NAME --delete
## 📁 Estrutura do Projeto
# Invalidar cache CloudFront (substitua DISTRIBUTION-ID)
MCPS-K/```
├── .vscode/
│ └── mcp.json # Configuração dos servidores MCP## 🛠️ Tecnologias Utilizadas
├── deploy.ps1 # Script de automação de deploy
├── MCP_SETUP.md # Documentação completa### Backend
├── .gitignore # Arquivos ignorados pelo Git- Node.js + Express: API REST
└── README.md # Este arquivo- MongoDB + Mongoose: Banco de dados
- **dotenv**: Variáveis de ambiente
## 🔧 MCPs Incluídos
### Frontend
### Terraform MCP- **React**: Interface de usuário
- **Função**: Acesso à documentação atualizada do Terraform Registry- **Create React App**: Configuração inicial
- **Comando**: `terraform-mcp-server.exe`- **Componentes customizados**: OrderForm, OrderList
- **Uso**: Perguntas sobre providers, módulos e recursos Terraform
### Infraestrutura
### GitHub MCP- **AWS S3**: Hospedagem de site estático
- **Função**: Gerenciar repositórios, issues, PRs e workflows- **AWS CloudFront**: CDN global
- **Comando**: `mcp-server-github`- **Terraform**: Infrastructure as Code
- **Requer**: GitHub Personal Access Token (opcional)
## 📊 Funcionalidades
### Memory MCP
- **Função**: Manter contexto persistente entre sessões- ✅ Criar pedidos de hambúrguer
- **Comando**: `mcp-server-memory`- ✅ Listar pedidos existentes
- **Uso**: Armazenar informações importantes do projeto- ✅ Interface responsiva
- ✅ API REST completa
### Filesystem MCP- ✅ Deploy automatizado na AWS
- **Função**: Acesso seguro aos arquivos do workspace- ✅ CDN para performance global
- **Comando**: `mcp-server-filesystem`
- **Escopo**: Apenas diretório do projeto## 💰 Custos AWS Estimados
### Brave Search MCP- **S3**: ~$0.50/mês
- **Função**: Busca web em tempo real- **CloudFront**: ~$1.00/mês
- **Comando**: `mcp-server-brave-search`- **Total**: ~$1.50/mês
- **Requer**: Brave API Key (opcional)
## 🔧 Scripts Disponíveis
## 💡 Como Usar
### Frontend
### No VS Code + GitHub Copilot- `npm start`: Servidor de desenvolvimento
- `npm run build`: Build de produção
1. Abra o **GitHub Copilot Chat** (Ctrl+Alt+I)- `npm test`: Executar testes
2. Configure para modo **Agent**
3. Clique no ícone **🔧 ferramentas**### Backend
4. Veja os MCPs disponíveis- `npm start`: Iniciar servidor
5. Comece a fazer perguntas!- `node index.js`: Executar diretamente
### Exemplos de Comandos### Terraform
- `.\deploy.ps1 -Plan`: Planejar mudanças
Terraform- .\deploy.ps1 -Destroy: Destruir recursos
"Como criar um bucket S3 com Terraform?"
"Mostre a documentação do provider AWS"## 📞 API Endpoints
GitHub- GET /: Status da API
"Liste meus repositórios recentes"- GET /orders: Listar pedidos
"Crie uma issue para adicionar testes"- POST /orders: Criar novo pedido
Filesystem### Exemplo de Pedido
"Liste todos os arquivos .ps1 no projeto"```json
"Leia o conteúdo do mcp.json"{
"customer": "João Silva",
Memory "items": [
"Lembre que usamos MongoDB na porta 27017" {
"Qual foi a última configuração que salvamos?" "name": "Big Burger",
"quantity": 2,
Brave Search "price": 20
"Pesquise as melhores práticas de PowerShell 2025" }
"Encontre tutoriais de MCP servers" ],
}
## 🔐 Configuração de Tokens```
### GitHub Token (Opcional)## 🔒 Segurança
1. Acesse https://github.com/settings/tokens
2. Crie um novo token com permissões de `repo`- HTTPS forçado via CloudFront
3. VS Code solicitará o token na primeira execução- Bucket S3 com acesso controlado
- CORS configurado no backend
### Brave API Key (Opcional)- Variables de ambiente para credenciais
1. Acesse https://brave.com/search/api/
2. Crie uma conta e obtenha a chave## 📝 Próximos Passos
3. VS Code solicitará a chave quando necessário
- [ ] Autenticação de usuários
## 🔄 Atualização- [ ] Painel administrativo
- [ ] Sistema de pagamento
Atualizar MCPs para versões mais recentes- [ ] Domínio customizado no CloudFront
.\deploy.ps1 -Action Update- [ ] CI/CD com GitHub Actions
Fazer pull das últimas mudanças## 🤝 Contribuição
git pull origin main
- Faça um fork do projeto
Aplicar novas configurações2. Crie uma branch para sua feature
.\deploy.ps1 -Action Deploy3. Commit suas mudanças
5. Abra um Pull Request
## 🛠️ Troubleshooting
## 📄 Licença
### MCPs não aparecem no VS Code
Validar configuração
.\deploy.ps1 -Action Validate
Verificar status
.\deploy.ps1 -Action Status
Reiniciar VS Code completamente
### Erro "command not found"
- Verifique se Node.js está instalado: `node --version`
- Reinstale os MCPs: `.\deploy.ps1 -Action Install`
### Git push falhaConfigurar credenciais do Git
git config --global user.name "Seu Nome" git config --global user.email "seu@email.com"
Primeiro push
git push -u origin main
## 📊 Status dos MCPs
Execute `.\deploy.ps1 -Action Status` para ver:
- ✅ MCPs instalados e versões
- 📁 Arquivos de configuração
- 🔄 Status do Git
- ⚠️ Mudanças pendentes
## 🤝 Contribuindo
1. Fork o projeto
2. Crie uma branch: `git checkout -b feature/nova-funcionalidade`
3. Commit suas mudanças: `git commit -m 'Adiciona nova funcionalidade'`
4. Push para a branch: `git push origin feature/nova-funcionalidade`
5. Abra um Pull Request
## 📝 Changelog
### v1.0.0 - 2025-10-15
- ✨ Configuração inicial dos MCPs
- 🚀 Script de deploy automatizado
- 📖 Documentação completa
- 🔧 Suporte para 5 servidores MCP principais
## 📄 Licença
MIT License - veja o arquivo LICENSE para detalhes
## 🔗 Links Úteis
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Terraform MCP Server](https://developer.hashicorp.com/terraform/mcp-server)
- [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
-
## 📧 Contato
- GitHub: [@kcsdevops](https://github.com/kcsdevops)
- Repository: [MCPS-K](https://github.com/kcsdevops/MCPS-K)
---
**Feito com ❤️ para a comunidade DevOps**