1Panel MCP Server

1Panel MCP サーバー

1Panel MCP サーバーは、1Panel 用の Model Context Protocol（MCP）サーバーの実装です。

インストール

前提条件

• Go 1.25.0 以降
• 既存の 1Panel

ソースからビルド

1. リポジトリをクローンします：

   git clone https://github.com/1Panel-dev/mcp-1panel.git
   cd mcp-1panel
   

2. プロジェクトをビルドします：

   make build
   

   ./build/mcp-1panel をシステムの環境パスに移動します。

go install を使用してインストール

go install github.com/1Panel-dev/mcp-1panel@latest

使用方法

Cursor と Windsurf の設定例：

stdio モード

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

スタンドアロン TLS を使用した Streamable HTTP

mcp-1panel は、独自のローカル CA と HTTPS サーバー証明書を作成して保持できます。1Panel の証明書管理には依存しません。

MCP_AUTH_TOKEN=<strong random MCP token> \
PANEL_HOST=<your 1Panel access address> \
PANEL_ACCESS_TOKEN=<your 1Panel access token> \
mcp-1panel \
  -transport streamable-http \
  -addr "https://127.0.0.1:8000/mcp" \
  -tls-hosts "localhost,127.0.0.1"

初回起動時に、サーバーは CA のパスと SHA-256 フィンガープリントを stderr に書き込みます。生成された ca.crt を信頼するように MCP クライアントを設定してください。証明書の検証を無効にしないでください。CA は再利用され、サーバー証明書は自動的に更新されます。

HTTP トランスポートでは、デフォルトで MCP 認証トークンが必要です。クライアントは各リクエストで Authorization: Bearer <token> としてトークンを送信する必要があります。非公開の X-MCP-Token ヘッダーは受け付けられません。この方式は単一ユーザー向けのプライベートなデプロイを想定した事前共有トークン方式であり、MCP OAuth 認可フローではありません。標準に準拠したマルチユーザー認可が必要な場合は、サーバーを OAuth 対応ゲートウェイの背後に配置してください。

可能な場合は、ローカルのデスクトップクライアントには stdio を使用してください。ループバック以外のリスナーには、https:// アドレス、-allow-remote-http、トークン、明示的な証明書 SAN、および適切な Origin 許可リストが必要です。

アクセスレベル

サーバーのデフォルトは readonly です。ツールの権限はツールの登録時に適用されるため、許可されていないツールは tools/list で返されず、直接呼び出すこともできません。

レベル	ツール
readonly	クエリ、一覧表示、ステータスの読み取り
readwrite	readonly に加えて、既存の Web サイト、証明書、データベースの作成ツール
full	readwrite に加えて、既存のアプリケーションインストールツール

-access-level または MCP_ACCESS_LEVEL でレベルを設定します。コマンドラインの設定が優先されます。

コマンドラインオプション

• -token：1Panel アクセストークン。プロセス一覧でシークレットが露出しないよう、PANEL_ACCESS_TOKEN の使用を推奨します
• -host：1Panel アクセスアドレス。環境変数による設定には PANEL_HOST の使用を推奨します
• -transport：トランスポートの種類（stdio または streamable-http、デフォルト：stdio）
• -addr：HTTP トランスポートのベース URL（デフォルト：http://127.0.0.1:8000）
• -mcp-token：HTTP トランスポート用の事前共有 Bearer トークン
• -allowed-origins：HTTP トランスポート用のカンマ区切りの Origin 許可リスト
• -allow-insecure-http：認証なしの HTTP トランスポートを許可します。ローカル開発でのみ使用してください
• -allow-remote-http：ループバック以外のアドレスで HTTPS トランスポートのリッスンを許可します
• -access-level：ツールのアクセスレベル（readonly、readwrite、full のいずれか。デフォルト：readonly）
• -tls-dir：ローカル CA と HTTPS サーバー証明書のディレクトリ
• -tls-hosts：HTTPS サーバー証明書用のカンマ区切りの DNS 名と IP アドレス

環境変数

環境変数を使用してサーバーを設定することもできます：

• PANEL_HOST：1Panel アクセスアドレス
• PANEL_ACCESS_TOKEN：1Panel アクセストークン
• MCP_AUTH_TOKEN：streamable-http 用の事前共有 Bearer トークン
• MCP_ACCESS_LEVEL：ツールのアクセスレベル（readonly、readwrite、full のいずれか）

利用可能なツール

サーバーは、1Panel を操作するためのさまざまなツールを提供します。

ツール	カテゴリー	最小アクセス権	説明
get_dashboard_info	システム	readonly	ダッシュボードのステータスを一覧表示します
get_system_info	システム	readonly	システム情報を取得します
list_websites	ウェブサイト	readonly	すべてのウェブサイトを一覧表示します
create_website	ウェブサイト	readwrite	ウェブサイトを作成します
list_ssls	証明書	readonly	すべての証明書を一覧表示します
create_ssl	証明書	readwrite	証明書を作成します
list_installed_apps	アプリケーション	readonly	インストール済みのすべてのアプリケーションを一覧表示します
install_openresty	アプリケーション	full	OpenResty をインストールします
install_mysql	アプリケーション	full	MySQL をインストールします
list_databases	データベース	readonly	すべてのデータベースを一覧表示します
create_database	データベース	readwrite	データベースを作成します