VPS MCP Server

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

# 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 - Como instalar no Antigravity IDE
Setup Guide - Guia de instalação e configuração
Architecture - Arquitetura do sistema
API Reference - Referência completa das ferramentas MCP
Install Node.js - Como instalar Node.js

🔧 Requisitos

Node.js 18+
Acesso a uma instância Portainer
Chave de API do Portainer