1panel-dev/mcp-1panel
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
1panel-dev/mcp-1panelは、https://github.com/1panel-dev/mcp-1panel.からインポートされたMCPサーバー候補です。
概要
1panel-dev/mcp-1panelは、https://github.com/1panel-dev/mcp-1panel.からインポートされたMCPサーバー候補です。
概要（AI 翻訳）
1Panel MCPサーバーは、1Panel向けのモデルコンテキストプロトコル(MCP)サーバーの実装です。
設置
前提条件
- 1.25.0以上に
- 既存の1パネル
ソースからビルド
-
リポジトリのクローン:
-
プロジェクトの構築:
./build/mcp-1panelをシステム環境パスに移動させます。
Go installを使ってインストール
使用法
カーソルとウィンドサーフィン構成例:
標準モード
スタンドアロンTLSを使ったストリーミング可能なHTTP
mcp-1panelは独自のローカルCAおよびHTTPSサーバー証明書を作成・永続化できます。これは1Panelの証明書管理に依存しません。
初回起動時に、サーバーはCAパスとSHA-256指紋をstderrに書き込みます。MCPクライアントを生成されたca.crtを信頼するように設定します。証明書検証は無効化しないでください。CAは再利用され、サーバー証明書は自動的に更新されます。
HTTPトランスポートにはデフォルトでMCP認証トークンが必要です。クライアントはすべてのリクエストで認証トークンをAuthorization: Bearer として送信しなければなりません。プライベートのX-MCP-Tokenヘッダーは受け入れられません。これは単一ユーザー/プライベート展開向けの事前共有トークンモードであり、MCP OAuth認証フローではありません。
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
1Panel MCP Server
An MCP server for 1Panel v2, with 20 shared tools for nodes, system status, websites, certificates, applications and MySQL. Independent mode uses the official Go MCP SDK; managed mode integrates with 1Panel’s authorization and audit.
Choose a mode
| Mode | Connection and authorization | Deployment |
|---|---|---|
Independent: --mode=legacy (default) |
Configured API Key calls existing public /api/v2 APIs; panel permissions apply to every request |
stdio or Streamable HTTP, as a binary or Docker container |
Managed: --mode=panel |
Dedicated MCP credential; Core checks the owner’s current permissions, node/tool grants and policy | Docker on the primary node, installed from AI → MCP Management → 1Panel MCP |
Independent mode requires an enabled public API and compatible APIs/DTOs for the selected tools on your installed 1Panel v2 release. It needs no managed MCP installation. Managed mode requires matching Core, primary/child Agents and frontend. See managed deployment.
| Credential | Purpose |
|---|---|
PANEL_ACCESS_TOKEN / --token |
1Panel API Key used by independent mode for outgoing panel requests |
MCP_AUTH_TOKEN / --mcp-token |
Separate pre-shared Bearer used by clients connecting to independent Streamable HTTP |
| Token created in the panel’s MCP page | Dedicated managed credential with explicit node/tool grants; clients use the panel’s HTTPS /mcp endpoint |
The independent HTTP token permits use of the configured API Key; it does not create another panel identity. The two modes’ MCP credentials are not interchangeable.
Install
Source
Use Go 1.27.3. The v2 source branch is dev-v2:
git clone --branch dev-v2 https://github.com/1Panel-dev/mcp-1panel.git
cd mcp-1panel
go mod download
make build
./build/mcp-1panel --version
make build creates a host-platform binary at build/mcp-1panel.
To cross-build Linux, use make build_linux GOARCH=amd64 or GOARCH=arm64;
make build_linux_all builds all seven architectures: 386, amd64, arm64, armv7, s390x, ppc64le and riscv64.
Linux builds require a locally available toolchain and cached dependencies;
outputs are build/mcp-1panel-linux-{arch}.
Release binary
Choose an explicitly published v2 release from Releases
compatible with your installed panel’s public APIs. Download the matching architecture
and SHA256SUMS, verify the checksum, then run, for example on Linux amd64:
chmod +x ./mcp-1panel-linux-amd64
./mcp-1panel-linux-amd64 --version
Use that binary’s absolute path in the client configuration below.
For maintainers, publishing a GitHub Release triggers tests, builds all seven Linux binaries,
uploads them with SHA256SUMS to that release, and pushes the multi-platform Docker image.
インストール
docker run -i --rm -e PANEL_HOST -e PANEL_ACCESS_TOKEN \設定
{
"mcpServers": {
"mcp-1panel": {
"command": "/absolute/path/to/mcp-1panel",
"args": ["--mode=legacy", "--transport=stdio", "--access-level=readonly"],
"env": {
"PANEL_HOST": "https://panel.example",
"PANEL_ACCESS_TOKEN": "<1Panel API Key>",
"MCP_LANGUAGE": "en"
}
}
}
}