Integração do Servidor 1Panel MCP

O que faz o Servidor “1Panel” MCP?

O Servidor 1Panel MCP é uma implementação do servidor Model Context Protocol (MCP) desenvolvida especificamente para integração com o 1Panel. Ele atua como uma ponte conectando assistentes de IA à plataforma 1Panel, permitindo fluxos de trabalho de desenvolvimento aprimorados ao possibilitar que agentes de IA interajam programaticamente com as APIs e fontes de dados do 1Panel. Ao implantar este servidor, desenvolvedores podem utilizar ferramentas baseadas em IA para automatizar e simplificar tarefas administrativas e operacionais comuns em seus ambientes 1Panel, como consultar status do sistema, gerenciar arquivos ou executar comandos de controle. O servidor suporta múltiplos métodos de transporte (stdio e sse), oferecendo flexibilidade para integração em diversos ambientes, e pode ser configurado de forma segura com tokens de API e endereços de host.

Lista de Prompts

Não há modelos de prompt mencionados na documentação ou código disponível.

Lista de Recursos

Nenhum recurso MCP explícito é descrito na documentação ou código disponível.

Lista de Ferramentas

Não há ferramentas específicas listadas ou descritas na documentação ou código disponível (ex: server.py não existe neste projeto baseado em Go).

Casos de Uso deste Servidor MCP

• Automação do 1Panel: Integre assistentes de IA para automatizar tarefas administrativas do 1Panel, como reiniciar serviços, gerenciamento de usuários ou verificações de status via comandos padronizados de IA.
• Operações Remotas: Permita que scripts ou fluxos de trabalho baseados em IA interajam remotamente com servidores 1Panel, ampliando as capacidades de DevOps e administração de sistemas.
• Integração de IA SSE/Streaming: Habilite interações em tempo real entre o 1Panel e agentes de IA utilizando o modo de transporte SSE, permitindo monitoramento ao vivo e respostas rápidas.
• Acesso Programático Seguro: Utilize tokens de acesso e configuração baseada em variáveis de ambiente para expor de forma segura apenas as partes necessárias do 1Panel aos agentes de IA, mantendo a segurança operacional.

Como configurar

Windsurf

1. Certifique-se de ter o binário do Servidor 1Panel MCP ou a imagem Docker.

2. Obtenha seu token de acesso do 1Panel e a URL do host.

3. Edite o arquivo de configuração do Windsurf.

4. Adicione o seguinte trecho JSON em mcpServers:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<seu token de acesso do 1Panel>",
           "PANEL_HOST": "como http://localhost:8080"
         }
       }
     }
   }
   

5. Salve e reinicie o Windsurf, depois verifique a conexão com o servidor.

Exemplo Docker

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "como http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<seu token de acesso do 1Panel>"
      }
    }
  }
}

Claude

1. Baixe ou construa o Servidor 1Panel MCP.
2. Adquira seu token de API do 1Panel e informações do host.
3. Abra o arquivo de configuração do Claude.
4. Insira a mesma configuração usada no Windsurf em mcpServers.
5. Salve e reinicie o Claude.

Cursor

1. Certifique-se de que o Servidor 1Panel MCP está instalado.

2. Obtenha seu token de acesso e a URL do host.

3. Edite o arquivo de configuração do Cursor.

4. Adicione:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<seu token de acesso do 1Panel>",
           "PANEL_HOST": "como http://localhost:8080"
         }
       }
     }
   }
   

5. Salve as alterações e reinicie o Cursor.

Exemplo de Modo SSE

Se estiver utilizando o modo SSE, inicie o servidor com:

mcp-1panel -host http://localhost:8080 -token <seu token de acesso do 1Panel> -transport sse -addr http://localhost:8000

Adicione em mcpServers:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cline

1. Instale o Servidor 1Panel MCP.
2. Defina seu PANEL_ACCESS_TOKEN e PANEL_HOST.
3. Edite o arquivo de configuração do Cline e insira o mesmo JSON acima.
4. Salve e reinicie o Cline.

Protegendo as Chaves de API

Armazene chaves de API e informações sensíveis em variáveis de ambiente. Exemplo de configuração:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "${PANEL_ACCESS_TOKEN}",
        "PANEL_HOST": "${PANEL_HOST}"
      }
    }
  }
}

Substitua ${PANEL_ACCESS_TOKEN} e ${PANEL_HOST} pelos nomes das suas variáveis de ambiente.

Como utilizar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://seuservidormcp.exemplo/caminhoparamcp/url"
  }
}

Uma vez configurado, o agente de IA poderá utilizar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “MCP-name” para “mcp-1panel” e substituir a URL pelo endereço do seu próprio servidor MCP.

Visão Geral

Nossa opinião

O Servidor 1Panel MCP oferece instruções claras de instalação e integração, sendo ativamente mantido e com bom número de estrelas e forks. No entanto, a ausência de descrições detalhadas sobre ferramentas, prompts e recursos na documentação limita sua usabilidade pronta para fluxos de trabalho de IA mais complexos. Com base no exposto, avaliamos esta implementação MCP com 5/10 em completude e facilidade para desenvolvedores.

Pontuação MCP