# MCP Server para Gerenciamento Portainer
Servidor MCP (Model Context Protocol) que permite ao modelo de IA gerenciar containers Docker através da API do Portainer.
## 📋 Visão Geral
Este projeto implementa um MCP Server que expõe ferramentas para gerenciar:
- **Containers**: listar, criar, iniciar, parar, remover, inspecionar
- **Imagens**: listar, pull, remover, inspecionar
- **Networks**: listar, criar, remover
- **Volumes**: listar, criar, remover
- **Configuração**: definir/obter credenciais do Portainer
## 🚀 Quick Start
```bash
# Clonar o repositório
git clone https://github.com/onlitec/VPS-MCP-SERVER.git
cd VPS-MCP-SERVER
# Instalar dependências
npm install
# Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com suas credenciais do Portainer
# Build
npm run build
# Testar conexão
npm run test:connection
```
## 📚 Documentação
- [**Antigravity Setup**](docs/ANTIGRAVITY_SETUP.md) - Como instalar no Antigravity IDE
- [Setup Guide](docs/SETUP.md) - Guia de instalação e configuração
- [Architecture](docs/ARCHITECTURE.md) - Arquitetura do sistema
- [API Reference](docs/API_REFERENCE.md) - Referência completa das ferramentas MCP
- [Install Node.js](docs/INSTALL_NODEJS.md) - Como instalar Node.js
## 🔧 Requisitos
- Node.js 18+
- Acesso a uma instância Portainer
- Chave de API do Portainer
## 📝 Licença
MIT