Integracja serwera MCP 1Panel

Do czego służy serwer MCP “1Panel”?

1Panel MCP Server to implementacja serwera Model Context Protocol (MCP) stworzona specjalnie do integracji z 1Panel. Działa jako most łączący asystentów AI z platformą 1Panel, umożliwiając usprawnienie procesów deweloperskich poprzez programistyczny dostęp agentów AI do API i źródeł danych 1Panel. Dzięki wdrożeniu tego serwera, deweloperzy mogą wykorzystywać narzędzia oparte na AI do automatyzacji i optymalizacji typowych zadań administracyjnych i operacyjnych w środowiskach 1Panel, takich jak zapytania o status systemu, zarządzanie plikami czy wykonywanie poleceń kontrolnych. Serwer obsługuje wiele metod transportu (stdio i sse), oferując elastyczność integracji w różnych środowiskach, a także może być bezpiecznie skonfigurowany za pomocą tokenów API i adresów hostów.

Lista promptów

W dostępnej dokumentacji ani kodzie nie wspomniano o szablonach promptów.

Lista zasobów

W dostępnej dokumentacji ani kodzie nie opisano jawnych zasobów MCP.

Lista narzędzi

W dostępnej dokumentacji ani kodzie nie wymieniono ani nie opisano konkretnych narzędzi (np. server.py nie istnieje w tym projekcie opartym o Go).

Przykłady użycia tego serwera MCP

• Automatyzacja 1Panel: Integracja agentów AI do automatyzacji zadań administracyjnych 1Panel, takich jak restart usług, zarządzanie użytkownikami czy sprawdzanie statusu przez ustandaryzowane polecenia AI.
• Operacje zdalne: Umożliwienie skryptom lub przepływom AI interakcji z serwerami 1Panel na odległość, wspierając DevOps i możliwości administracji systemami.
• Integracja AI w trybie SSE/streaming: Pozwala na interakcje w czasie rzeczywistym między 1Panel a agentami AI przy użyciu trybu transportu SSE, umożliwiając monitoring na żywo i natychmiastowe odpowiedzi.
• Bezpieczny dostęp programistyczny: Wykorzystanie tokenów dostępu i konfiguracji opartej na środowisku, aby bezpiecznie udostępnić agentom AI tylko niezbędne części 1Panel, zachowując bezpieczeństwo operacyjne.

Jak to skonfigurować

Windsurf

1. Upewnij się, że masz plik binarny serwera MCP 1Panel lub obraz Dockera.

2. Uzyskaj swój token dostępu 1Panel oraz adres URL hosta.

3. Edytuj plik konfiguracyjny Windsurf.

4. Dodaj poniższy fragment JSON w sekcji mcpServers:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<twój token dostępu 1Panel>",
           "PANEL_HOST": "np. http://localhost:8080"
         }
       }
     }
   }
   

5. Zapisz i zrestartuj Windsurf, następnie zweryfikuj połączenie z serwerem.

Przykład Docker

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "np. http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<twój token dostępu 1Panel>"
      }
    }
  }
}

Claude

1. Pobierz lub zbuduj serwer MCP 1Panel.
2. Uzyskaj swój token API 1Panel oraz informacje o hoście.
3. Otwórz plik konfiguracyjny Claude’a.
4. Wstaw tę samą konfigurację co dla Windsurf w sekcji mcpServers.
5. Zapisz i zrestartuj Claude.

Cursor

1. Upewnij się, że serwer MCP 1Panel jest zainstalowany.

2. Pobierz swój token dostępu oraz adres URL hosta.

3. Edytuj plik konfiguracyjny Cursor.

4. Dodaj:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<twój token dostępu 1Panel>",
           "PANEL_HOST": "np. http://localhost:8080"
         }
       }
     }
   }
   

5. Zapisz zmiany i zrestartuj Cursor.

Przykład trybu SSE

Jeśli używasz trybu SSE, uruchom serwer poleceniem:

mcp-1panel -host http://localhost:8080 -token <twój token dostępu 1Panel> -transport sse -addr http://localhost:8000

Dodaj do mcpServers:

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

Cline

1. Zainstaluj serwer MCP 1Panel.
2. Ustaw PANEL_ACCESS_TOKEN i PANEL_HOST.
3. Edytuj plik konfiguracyjny Cline i wstaw ten sam JSON jak powyżej.
4. Zapisz i zrestartuj Cline.

Zabezpieczanie kluczy API

Przechowuj klucze API i dane wrażliwe w zmiennych środowiskowych. Przykładowa konfiguracja:

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

Zamień ${PANEL_ACCESS_TOKEN} i ${PANEL_HOST} na nazwy swoich zmiennych środowiskowych.

Jak korzystać z tego MCP w flow

Korzystanie z MCP w FlowHunt

Aby zintegrować serwery MCP w swoim przepływie pracy FlowHunt, zacznij od dodania komponentu MCP do flow i połączenia go z agentem AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracji. W sekcji konfiguracji systemowego MCP wstaw dane swojego serwera MCP w tym formacie JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po skonfigurowaniu agent AI będzie mógł korzystać z tego MCP jako narzędzia z dostępem do wszystkich jego funkcji i możliwości. Pamiętaj, aby zamienić “MCP-name” na “mcp-1panel” i podać swój własny adres URL serwera MCP.

Przegląd

Nasza opinia

Serwer MCP 1Panel oferuje przejrzyste instrukcje instalacji i integracji oraz jest aktywnie rozwijany z dobrą liczbą gwiazdek i forków. Jednak brak szczegółowych opisów narzędzi, promptów i zasobów w dokumentacji ogranicza jego gotowość do złożonych przepływów AI “out-of-the-box”. Na tej podstawie oceniamy tę implementację MCP na 5/10 pod kątem kompletności i przyjazności dla dewelopera.

Ocena MCP