Provides tools for managing Docker containers, images, networks, and volumes via Portainer, including listing, creating, starting, stopping, removing, and inspecting Docker resources.
Enables management of Docker containers, images, networks, and volumes through Portainer's API, including operations like creating, starting, stopping, removing, and inspecting resources.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VPS MCP Serverlist all running Docker containers on my VPS"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
📝 Licença
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.