1Panel MCP Server V1
Provides tools for managing a 1Panel v1 instance through its API, covering containers, images, Docker Compose, applications, runtimes (PHP/Node.js), files, backups, system monitoring, firewall, databases (MySQL/PostgreSQL/Redis), websites, certificates, and scheduled tasks.
Click on "Deploy 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., "@1Panel MCP Server V1 list my running Docker containers and their status"
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.
1Panel MCP Server — V1 版
⚠️ 这是 1Panel V1 版本
本项目基于
version: v1.10.34-lts构建与实测,只调用/api/v1/*接口。
✅ 适用于 1Panel v1.x(v1.10.34-lts 实测通过)
❌ 不兼容 1Panel v2 —— v2 使用
/api/v2/*路径,接口路径与字段语义均不同如果你用的是 v2,请使用上游面向 v2 的
EaveLuo/1panel-mcp
通过 MCP(Model Context Protocol)让 AI 客户端(Claude Desktop、Cursor、Claude Code 等)直接管理你的 1Panel v1 面板。
Related MCP server: easypanel-mcp
为什么需要这个 V1 版本
上游 1panel-mcp 面向 1Panel v2 编写,全部 289 处端点硬编码为 /api/v2/...。
在 v1.10.34-lts 面板上实测全部调用失败(v1 的 /api/v2 路由数为 0,请求会落到安全入口守卫页返回 HTML)。
本项目把端点整体移植到 /api/v1/*,并逐条核对 v1 的 请求体字段名、HTTP 方法、参数形态,而不是简单替换路径前缀。
关键差异例如:
能力 | v2 写法 | v1 实际写法 |
容器启停 |
|
|
删除容器 |
|
|
容器详情 |
|
|
拉取镜像 |
|
|
容器日志 |
|
|
Docker 状态 |
|
|
同时修复了上游的若干实现缺陷(详见 修复记录)。
特性
257 个 MCP 工具,覆盖 1Panel v1 的主要管理能力
端点逐条核对:239 个 API 调用点与 v1.10.34-lts 的规范逐条比对,路径 + HTTP 方法 100% 匹配
真实面板实测:
npm run smoke会通过 MCP 协议真实调用只读接口,本项目的开发结论全部来自真机验证正确的鉴权实现:
1Panel-Token = md5("1panel" + API-Key + UnixTimestamp)可靠的错误处理:识别 1Panel「HTTP 200 + body.code」的业务错误、以及安全入口返回的 HTML 守卫页
明确的降级:v1 没有的能力会抛出带说明的错误,而不是发出一个必然失败的请求
零多余依赖:仅依赖
@modelcontextprotocol/sdk(CLI 参数解析改为手写,去掉 commander)
支持的模块
分类 | 模块 |
容器与镜像 | 容器、镜像、网络、存储卷、Docker Compose |
应用与运行时 | 应用商店、运行环境、PHP、Node.js |
文件 / 备份 / 快照 | 文件管理、备份与恢复、回收站、快照 |
系统 / 主机 / 监控 | 系统信息、主机管理、设备、磁盘、进程、监控、SSH、日志、设置、任务、面板概览 |
安全与运维工具 | 防火墙、Fail2ban、FTP、ClamAV |
其他 | 网站与证书、数据库(MySQL/PostgreSQL/Redis)、定时任务、Ollama、OpenResty |
不支持(1Panel v1 无对应接口,属 v2 / XPack 专有):AI Agent、MCP Server、GPU 监控。
已知限制
以下几类地方,调用时会返回明确的中文错误而不是静默失败。这是有意为之—— v1 缺少对应能力或参数,与其发出一个必然失败的请求,不如直接说清楚:
工具入参未跟上 v1 形状(6 个):
delete_firewall_rule、operate_fail2ban_ssh、get_clam_records、clean_clam_records、update_clam_status、postgresql_change_privileges。 这些工具在 v1 需要额外必填参数(如规则类型、IP 列表、clamID、实例名), 当前inputSchema仍是上游 v2 的形状,调用时会提示缺少什么。 欢迎 PR 补齐——改动只在src/tools/*.ts。同类批量能力:v1 的删除类接口多为批量(
{ids:[...]}),工具层若只传单个 id 仍可工作, 但部分场景需要显式传数组。冒烟覆盖率:
npm run smoke覆盖的是「无需参数即可执行」的只读工具(59/257), 其余需要真实资源 id,不适合自动化调用。
快速开始
1. 安装
git clone <this-repo>
cd 1panel-mcp-v1
npm install
npm run build2. 获取 API 密钥
登录 1Panel → 面板设置 → API 接口 → 启用接口并生成密钥。
务必把调用方 IP 加入白名单(白名单不符会返回 调用 API 接口 IP 不在白名单)。
注意这是面板密钥,和客户端连接 MCP 用的访问令牌是两回事 —— 见 两个密钥的分工。客户端设备只需要后者。
3. 启动
export ONEPANEL_HOST=127.0.0.1
export ONEPANEL_PORT=36437 # 你的 1Panel 实际端口
export ONEPANEL_API_KEY=your-api-key
node dist/index.js # 作为 MCP server 运行(stdio)或用 CLI:
npx 1panel-mcp-v1 start --host 127.0.0.1 --port 36437 --key your-api-key4. HTTP 传输(远程 / 组网访问)
stdio 适合本机客户端拉起;要让其它设备(另一台电脑、平板、手机、容器里的 Agent) 用同一个 MCP,需要 HTTP 传输:
export MCP_TOKEN=your-api-key # 同时用作面板 API 密钥 + HTTP 访问令牌
export ONEPANEL_HOST=127.0.0.1
export ONEPANEL_PORT=36437
node dist/http.js # 默认监听 127.0.0.1:8790只设 MCP_TOKEN 即可:未设置 ONEPANEL_API_KEY 时,它会自动作为面板 API 密钥使用。
监听地址与端口:
# 监听 Tailscale 虚拟地址,组网内的设备都能访问
# (tailscale ip -4 会输出本机的 100.x.y.z 地址)
MCP_HOST=$(tailscale ip -4) MCP_PORT=8790 node dist/http.js
# 或用 CLI / 启动脚本
npx 1panel-mcp-v1 serve --bind "$(tailscale ip -4)" --mcp-port 8790
scripts/serve.sh # 读取 .env.local
scripts/serve.sh --daemon # 后台运行(serve.log / serve.pid)
scripts/serve.sh --status | --stop把 MCP_HOST 写进 .env.local 时填你自己 tailscale ip -4 的输出;也可以填 0.0.0.0
监听全部网卡(那样局域网也能访问,请自行确认网络环境可信)。
端点:
端点 | 方法 | 说明 |
| POST / GET / DELETE | Streamable HTTP(推荐) |
| GET / POST | 旧版 HTTP+SSE 传输(兼容老客户端) |
| GET | 存活探测,无需鉴权,不泄漏面板信息 |
安全约定: 除 /health 外所有端点都要求令牌,通过
Authorization: Bearer <MCP_TOKEN> 或 X-MCP-Token: <MCP_TOKEN> 携带。
MCP_HOST 为非回环地址且未设置 MCP_TOKEN 时,服务会拒绝启动 ——
它持有面板管理员密钥,裸奔在网络上等于把面板交出去。
绑定到具体地址(而不是 0.0.0.0)可确保只有该网卡可达,例如绑定 Tailscale 地址后
局域网 IP 无法访问。
客户端兼容性: 本服务对两类常见的客户端问题做了兼容处理 ——
部分客户端不发
Accept头或只发application/json(MCP 规范要求同时接受text/event-stream,SDK 会因此回 406)。服务端会自动补全,不会握手失败。OAuth 发现路径(
/.well-known/oauth-*、/register)一律返回 404 而不是 401, 避免客户端误以为存在 OAuth 流程而陷入一连串无意义的探测。未知路径同样返回 404。
5. 长期常驻(systemd)
scripts/serve.sh --daemon 适合手动后台运行;要长期常驻(开机自启、崩溃自动重启、
日志进 journald、资源限制、systemctl 统一管理),用 systemd:
cd /path/to/1panel-mcp-v1 # 仓库根目录
sudo deploy/install-systemd.sh一条命令搞定。脚本会依次:校验前置条件(.env.local、dist/http.js、node 路径)→
把单元模板里的 __USER__ / __INSTALL_DIR__ 替换成本机实际值 →
systemd-analyze verify 校验 → 释放监听端口(停掉手工启动的本服务实例,
其它占用者会报错而不是被强杀)→ daemon-reload + enable --now。
常用管理命令:
systemctl status 1panel-mcp-v1
journalctl -u 1panel-mcp-v1 -f # 日志(已进 journald)
sudo systemctl restart 1panel-mcp-v1
sudo deploy/install-systemd.sh --uninstall安装前可以先干跑校验(无需 root,只生成到临时目录并 systemd-analyze verify):
deploy/install-systemd.sh --dry-run单元文件 deploy/1panel-mcp-v1.service 里做了这些事:
项 | 配置 |
开机自启 |
|
崩溃重启 |
|
日志 |
|
资源限制 |
|
优雅停止 |
|
Tailscale |
|
重启频率 |
|
加固 |
|
服务以安装目录的属主身份运行(sudo 安装时取 $SUDO_USER),因此能读到权限 600 的
.env.local。注意监听地址若绑定 Tailscale 虚拟 IP,务必先用 tailscale ip -4 确认该地址,
否则 listen() 会返回 EADDRNOTAVAIL(systemd 下会自动重试)。
环境变量
变量 | 说明 | 默认 |
| 1Panel 地址 |
|
| 1Panel 端口 |
|
| 面板 API 密钥(未设置时回退到 | — |
|
|
|
| HTTP 访问令牌;也用作面板密钥回退 | — |
| HTTP 监听地址( |
|
| HTTP 监听端口( |
|
| Streamable HTTP 路径 |
|
| 请求体上限(字节) |
|
配置示例见 .env.example。
两个密钥的分工
本服务涉及两个不同的密钥,职责完全分离 —— 客户端设备只需要其中一个:
面板 API 密钥 | MCP 访问令牌 | |
变量 |
|
|
作用 | 服务端调用 1Panel | 客户端连接 MCP 端点时的身份 |
配在哪 | 只在本机 | 服务器 + 每台客户端 |
怎么来 | 1Panel 面板 → 面板设置 → API 接口 → 生成 | 自己生成一串随机字符 |
客户端要吗 | 不需要 | 需要 |
泄漏后果 | 等于交出面板管理员权限 | 只能通过 MCP 调用工具 |
ONEPANEL_API_KEY MCP_TOKEN
(只在本机,不出门) (发给各客户端设备)
┌────────┐ ◄─────────────────── ┌───────────────┐ ◄────────────── ┌──────────┐
│ 1Panel │ 127.0.0.1:36437 │ 1panel-mcp-v1 │ 100.x.y.z:8790 │ opencode │
│ 面板 │ │ HTTP 服务 │ │ 平板/手机 │
└────────┘ └───────────────┘ └──────────┘.env.local 里两个都写,各司其职:
ONEPANEL_API_KEY=<面板生成的密钥> # 面板设置 → API 接口
MCP_TOKEN=<你自己生成的随机串> # 客户端拿这个连生成访问令牌:
openssl rand -hex 32只设 MCP_TOKEN 而不设 ONEPANEL_API_KEY 时,服务会把同一个值同时当作面板密钥使用
(单机快速起步时方便)。代价是每台客户端都持有了面板管理员密钥 —— 一台设备被攻破就等于
面板被接管。要分开就两个都设。
启动横幅会告诉你当前是哪种模式:
面板密钥来源 ONEPANEL_API_KEY ← 已分开,推荐
面板密钥来源 MCP_TOKEN(回退) ← 未设 ONEPANEL_API_KEY,两者共用同一个值MCP 客户端配置
Claude Desktop / Claude Code
{
"mcpServers": {
"1panel-v1": {
"command": "node",
"args": ["/绝对路径/1panel-mcp-v1/dist/index.js"],
"env": {
"ONEPANEL_HOST": "127.0.0.1",
"ONEPANEL_PORT": "36437",
"ONEPANEL_API_KEY": "your-api-key"
}
}
}
}Cursor
在 MCP 设置中新增:
{
"mcpServers": {
"1panel-v1": {
"command": "1panel-mcp-v1",
"args": ["start", "--host", "127.0.0.1", "--port", "36437", "--key", "your-api-key"]
}
}
}远程 / 组网 HTTP 客户端
支持 Streamable HTTP 的客户端(Claude Code、Cline、以及多数新版 Agent 框架):
{
"mcpServers": {
"1panel-v1": {
"type": "http",
"url": "http://100.x.y.z:8790/mcp",
"headers": { "Authorization": "Bearer your-mcp-token" }
}
}
}只支持旧版 SSE 的客户端:
{
"mcpServers": {
"1panel-v1": {
"type": "sse",
"url": "http://100.x.y.z:8790/sse",
"headers": { "Authorization": "Bearer your-mcp-token" }
}
}
}验证服务是否可达(不需要令牌):
curl http://100.x.y.z:8790/health
# {"status":"ok","name":"1panel-mcp","version":"1.0.0","transport":"http"}OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"1panel-v1": {
"type": "remote",
"url": "http://100.x.y.z:8790/mcp",
"oauth": false,
"enabled": true,
"headers": {
"Authorization": "Bearer {env:MCP_TOKEN}"
}
}
}
}三个容易踩的坑:
oauth必须显式设为false。 本服务用静态令牌,没有授权服务器。{env:VAR}在变量未设置时会替换成空字符串 —— 配置看起来完全正常, 但实际发出的是Authorization: Bearer,结果是 401。用这种方式就必须确保 OpenCode 的进程环境里真的有这个变量。不要照抄文档里的占位符。 OpenCode 官方示例写的是
"Bearer MY_API_KEY", 照抄就会把字面量MY_API_KEY当成令牌发出去,同样 401。
也可以直接写死令牌(本地配置、不外传的话最省事):
"headers": { "Authorization": "Bearer 你的实际令牌" }排查:本服务会把每个请求和拒绝原因打进日志(token 不匹配 / 未携带 token)。
若日志里出现 /.well-known/oauth-*、/register 的请求,说明客户端在走 OAuth 发现流程,
即令牌没被正确发送 —— 本服务对这些路径回 404,明确表示不支持 OAuth。
鉴权说明
1Panel v1 的外部 API 需要两个请求头,本 server 会自动计算:
1Panel-Token = md5("1panel" + API-Key + UnixTimestamp) # 秒级时间戳
1Panel-Timestamp = 当前 Unix 时间戳注意几个容易踩的点:
Token 不是 API Key 本身,直接用密钥会返回
401 API 接口密钥错误。API 路由不受安全入口影响:即使面板开了「安全入口」,
/api/v1/*也能直接调用,无需1pctl user-info查入口。若浏览器访问面板需要入口路径,那是 UI 层面的限制,与 API 无关。
故障排查
现象 | 原因 | 处理 |
客户端连接返回 | 客户端配置里的令牌不对(常见:把文档占位符原样抄了,或 | 日志会区分「未携带令牌」和「令牌不匹配」;按 两个密钥的分工 确认客户端用的是 |
日志里出现 | 客户端在走 OAuth 发现流程,说明它收到的令牌没通过校验 | 本服务不支持 OAuth,这些路径返回 404;按上一条检查令牌 |
重启服务后所有工具都报 | 改了 | 两个都要设,见 两个密钥的分工;启动横幅的「面板密钥来源」会显示是 |
| 把 API Key 当成了 Token | 确认用的是 md5 签名(本 server 已自动处理) |
| 调用方 IP 未加白 | 面板 → API 接口 → 白名单加上该 IP |
返回 HTML / | 路径在 v1 不存在,落到了安全入口守卫页 | 说明该端点是 v2 专有;本项目已改为抛出明确错误 |
| 该路由未开放给外部 API | 属面板侧限制,无法绕过 |
连接被拒 | 面板端口不对 | 用 |
修复记录
相对上游 1panel-mcp 修正的问题:
命名冲突导致 HTTP 方法被覆盖:
ContainerAPI.get(id)覆盖了BaseAPI.get(path), 导致getStatus()/getStats()/getLogs()实际发出POST /containers/info,把 URL 当成容器名。 改用super.get()。(该缺陷在上游 v2 版本中同样存在)业务错误被当成成功:1Panel 用
HTTP 200 + body.code表达错误,原实现只检查 HTTP 状态码。HTML 守卫页被当作 JSON 解析,报出难以理解的
Unexpected token '<'。日志端点形态错误:v1 外部 API 应使用
POST /containers/download/log。生命周期操作字段错误:v1 是
{names: [], operation}而非{id, operation}。移除
commander依赖,CLI 参数解析改为手写,减少安装失败面。
开发
npm run build # 编译到 dist/
npm run dev # 监听模式
npm start # stdio 模式(dist/index.js)
npm run serve # HTTP 模式(dist/http.js)
npm run smoke # 端到端冒烟:真实调用面板的只读接口(stdio)
npm run smoke:http # HTTP 传输测试:鉴权 / 会话 / 真实工具调用npm run smoke 需要先配好 ONEPANEL_* 环境变量,它只会调用 list_* / get_* / search_*
这类只读工具,不会修改面板状态;输出会区分「通过」「环境所致报错」「v1 主动抛错」三类。
npm run smoke:http 需要 MCP_TOKEN(以及 MCP_HOST / MCP_PORT),覆盖 15 项检查:
无令牌/错误令牌/缺 Bearer 前缀均返回 401、伪 session id 返回 404、正确令牌下完成
initialize → tools/list(257 个)→ 真实只读工具调用。
项目结构:
src/
├── index.ts # stdio 入口
├── http.ts # HTTP 入口(Streamable HTTP + 旧版 SSE + 令牌鉴权)
├── mcp-server.ts # MCP Server 工厂(工具注册与分发,两种传输共用)
├── client.ts # OnePanelClient(聚合各 API 模块)
├── cli.ts # 命令行入口(start / serve / config / tools)
├── api/ # 按模块划分的 API 封装(每个文件对应一类资源)
│ ├── base.ts # 请求层:鉴权签名、错误处理
│ └── ...
└── tools/ # MCP 工具定义(name / description / inputSchema)
deploy/
└── 1panel-mcp-v1.service # systemd 单元模板(长期常驻)
docs/
└── v1-api-notes.md # 1Panel v1 API 的实测笔记(移植时踩过的坑都记在这里)新增或修改接口前,请先读 docs/v1-api-notes.md ——
其中记录了 swagger 注解滞后、路由存在性探测方法、以及一堆 v2 与 v1 的字段/方法差异。
致谢
本项目移植自 EaveLuo/1panel-mcp(MIT)。 原项目的模块划分与工具定义是本项目的基础,在此致谢。
License
Available Tools
257 toolsapply_sslD
Apply SSL to website
Inputs: type (required), enable (required), websiteId (required), httpConfig, +3 more.
build_imageD
Build image
Inputs: name (required), path (required), dockerfile (required).
build_openrestyD
Build OpenResty (XPack)
Inputs: params (required).
check_backup_accountD
Check backup account
Inputs: type (required), vars (required).
check_device_dnsC
Check device DNS
Inputs: no named parameters.
check_fileC
Check if file exists
Inputs: path (required).
chmod_fileC
Change file permissions
Inputs: mode (required), path (required), sub.
chown_fileC
Change file owner
Inputs: path (required), user (required), group (required), sub.
clean_clam_recordsC
Clean ClamAV records
Inputs: no named parameters.
clean_compose_logC
Clean compose log
Inputs: id (required).
clean_container_logD
Clean container log
Inputs: id (required).
clean_monitor_dataC
Clean monitor data
Inputs: no named parameters.
clear_recycle_binC
Clear recycle bin
Inputs: no named parameters.
close_ollama_modelC
Close Ollama model connection (XPack)
Inputs: name (required).
commit_containerD
Commit container
Inputs: id (required), tag (required), repo (required).
compress_filesD
Compress files/directories
Inputs: dst (required), name (required), type (required), files (required), +2 more.
create_backupD
Create backup
Inputs: backup (required).
create_backup_accountD
Create backup account
Inputs: name (required), type (required), vars (required), isDefault.
create_certificateC
Create SSL certificate
Inputs: cert (required).
create_clam_configC
Create ClamAV config
Inputs: name (required), path (required), description.
create_composeD
Create compose
Inputs: name (required), content (required).
create_containerD
Create container
Inputs: config (required).
create_cronjobD
Create cronjob
Inputs: job (required).
create_databaseD
Create database
Inputs: db (required), type (required).
create_dirD
Create directory
Inputs: path (required).
create_fileC
Create empty file
Inputs: path (required).
create_firewall_ruleD
Create firewall rule
Inputs: rule (required).
create_ftp_userC
Create FTP user
Inputs: path (required), password (required), userName (required), description.
create_hostD
Create host
Inputs: addr (required), name (required), port, user, +5 more.
create_host_groupD
Create host group
Inputs: name (required), isDefault.
create_networkD
Create network
Inputs: name (required), driver.
create_ollama_modelC
Create Ollama model (XPack)
Inputs: name (required).
create_snapshotC
Create system snapshot
Inputs: name (required), withDocker, description.
create_volumeD
Create volume
Inputs: name (required).
create_websiteD
Create website
Inputs: site (required).
create_website_domainC
Add domain to website
Inputs: domain (required), websiteId (required), port.
decompress_fileC
Decompress archive
Inputs: dst (required), path (required), type (required), secret.
delete_backupD
Delete backup
Inputs: id (required).
delete_backup_accountD
Delete backup account
Inputs: type (required), name.
delete_certificateC
Delete SSL certificate
Inputs: id (required).
delete_clam_configC
Delete ClamAV config
Inputs: id (required).
delete_cronjobC
Delete cronjob
Inputs: id (required).
delete_databaseD
Delete database
Inputs: id (required), type (required).
delete_fileC
Delete file or directory
Inputs: path (required), forceDelete.
delete_firewall_ruleC
Delete firewall rule
Inputs: id (required).
delete_ftp_userC
Delete FTP user
Inputs: id (required).
delete_hostD
Delete host
Inputs: id (required).
delete_host_groupC
Delete host group
Inputs: id (required).
delete_host_ssh_keyC
Delete host SSH key
Inputs: id (required).
delete_ollama_modelC
Delete Ollama model (XPack)
Inputs: ids (required).
delete_snapshotC
Delete system snapshot
Inputs: ids (required).
delete_websiteD
Delete website
Inputs: id (required).
delete_website_domainC
Remove domain from website
Inputs: id (required).
download_fileD
Get download link
Inputs: path (required).
exec_commandD
Execute command
Inputs: command (required), cwd.
generate_host_ssh_keyC
Generate host SSH key
Inputs: id (required).
get_backup_account_client_infoD
Get backup account client info
Inputs: clientType (required).
get_backup_account_optionsC
Get backup account options
Inputs: no named parameters.
get_certificateC
Get SSL certificate details
Inputs: id (required).
get_clam_base_infoC
Get ClamAV base info
Inputs: no named parameters.
get_clam_fileC
Get ClamAV file config
Inputs: no named parameters.
get_clam_recordsC
Get ClamAV scan records
Inputs: no named parameters.
get_compose_envC
Get compose environment
Inputs: id (required).
get_containerD
Get container info
Inputs: id (required).
get_container_logsD
Get container logs
Inputs: id (required), tail.
get_container_statsD
Get container stats
Inputs: id (required).
get_container_statusD
Get containers status
Inputs: no named parameters.
get_container_usersD
Get container users
Inputs: name (required).
get_dashboard_base_infoD
Get dashboard base info
Inputs: no named parameters.
get_dashboard_current_infoC
Get dashboard current info
Inputs: no named parameters.
get_dashboard_memoC
Get dashboard memo
Inputs: no named parameters.
get_databaseD
Get database details
Inputs: id (required), type (required).
get_device_base_infoC
Get device base info
Inputs: no named parameters.
get_disk_full_infoC
Get full disk information
Inputs: no named parameters.
get_executing_task_countC
Get executing task count
Inputs: no named parameters.
get_fail2ban_base_infoC
Get Fail2ban base info
Inputs: no named parameters.
get_fail2ban_confB
Get Fail2ban configuration
Inputs: no named parameters.
get_file_contentC
Get file content
Inputs: path (required).
get_file_sizeC
Get file size
Inputs: path (required).
get_file_treeD
Get directory tree
Inputs: path (required).
get_ftp_base_infoC
Get FTP base info
Inputs: no named parameters.
get_ftp_logsC
Get FTP logs
Inputs: no named parameters.
get_hostD
Get host
Inputs: id (required).
get_host_ssh_confC
Get host SSH config
Inputs: no named parameters.
get_host_ssh_keyC
Get host SSH key
Inputs: id (required).
get_host_ssh_logsB
Get host SSH logs
Inputs: no named parameters.
get_host_treeC
Get host tree
Inputs: no named parameters.
get_httpsD
Get HTTPS configuration
Inputs: id (required).
get_monitor_dataD
Get monitor data
Inputs: endTime, startTime.
get_monitor_settingC
Get monitor setting
Inputs: no named parameters.
get_nginx_confC
Get Nginx configuration
Inputs: id (required).
get_node_modulesD
Get Node modules (XPack)
Inputs: id (required).
get_node_package_scriptsC
Get Node package scripts (XPack)
Inputs: id (required), params (required).
get_openresty_confB
Get OpenResty configuration (XPack)
Inputs: no named parameters.
get_openresty_modulesC
Get OpenResty modules (XPack)
Inputs: no named parameters.
get_openresty_partial_confB
Get OpenResty partial config (XPack)
Inputs: no named parameters.
get_openresty_statusB
Get OpenResty status (XPack)
Inputs: no named parameters.
get_php_confD
Get PHP config
Inputs: id (required).
get_php_conf_fileC
Get PHP config file
Inputs: id (required), type (required).
get_recycle_bin_statusB
Get recycle bin status
Inputs: no named parameters.
get_settingsC
Get settings
Inputs: no named parameters.
get_ssh_configC
Get SSH config
Inputs: no named parameters.
get_system_infoC
Get system info
Inputs: no named parameters.
get_system_monitorC
Get system monitor
Inputs: no named parameters.
get_task_logsC
Get task logs
Inputs: no named parameters.
get_websiteC
Get website details
Inputs: id (required).
get_website_sslC
Get website SSL certificate
Inputs: websiteId (required).
import_snapshotD
Import system snapshot
Inputs: from (required), names (required).
inspect_containerD
Inspect container
Inputs: id (required).
install_appD
Install app
Inputs: app (required).
install_environmentD
Install environment
Inputs: type (required), config (required).
install_php_extensionC
Install PHP extension
Inputs: id (required), extension (required).
kill_containerD
Kill container
Inputs: id (required).
kill_processD
Kill process
Inputs: pid (required).
list_all_imagesB
List all Docker images
Inputs: no named parameters.
list_app_storeD
List app store
Inputs: no named parameters.
list_backup_account_filesC
List files in backup account
Inputs: backupAccountID (required), path.
list_backup_accountsC
List backup accounts
Inputs: no named parameters.
list_backupsC
List backups
Inputs: no named parameters.
list_certificatesB
List SSL certificates
Inputs: no named parameters.
list_clam_configsC
List ClamAV configs
Inputs: no named parameters.
list_composesB
List compose projects
Inputs: no named parameters.
list_containersB
List Docker containers
Inputs: no named parameters.
list_containers_by_imageC
List containers by image
Inputs: image (required).
list_containers_simpleC
List containers (simple)
Inputs: no named parameters.
list_cronjobsC
List cronjobs
Inputs: no named parameters.
list_databasesD
List databases
Inputs: type (required).
list_disksC
List disks
Inputs: no named parameters.
list_environmentsD
List environments
Inputs: type (required).
list_filesC
List files in a directory
Inputs: path (required), page, pageSize.
list_firewall_rulesC
List firewall rules
Inputs: no named parameters.
list_ftp_usersC
List FTP users
Inputs: no named parameters.
list_host_groupsC
List host groups
Inputs: no named parameters.
list_hostsC
List hosts
Inputs: no named parameters.
list_imagesB
List Docker images
Inputs: no named parameters.
list_installed_appsC
List installed apps
Inputs: no named parameters.
list_networksC
List networks
Inputs: no named parameters.
list_ollama_modelsB
List Ollama models (XPack)
Inputs: no named parameters.
list_operation_logsC
List operation logs
Inputs: no named parameters.
list_php_extensionsC
List PHP extensions
Inputs: id (required).
list_php_runtimesB
List PHP runtimes
Inputs: no named parameters.
list_processesC
List processes
Inputs: no named parameters.
list_recycle_binB
List recycle bin files
Inputs: no named parameters.
list_snapshotsB
List system snapshots
Inputs: no named parameters.
list_system_logsC
List system logs
Inputs: no named parameters.
list_volumesC
List volumes
Inputs: no named parameters.
list_website_domainsD
List website domains
Inputs: websiteId (required).
list_websitesD
List websites
Inputs: no named parameters.
load_imageD
Load image
Inputs: path (required).
load_ollama_modelC
Load Ollama model (XPack)
Inputs: name (required).
load_snapshotD
Load snapshot data
Inputs: id (required).
mount_diskD
Mount disk
Inputs: path (required), mountPoint (required), fsType, options.
move_fileC
Move file/directory
Inputs: to (required), from (required), overwrite.
mysql_bind_userD
MySQL: Bind/create user
Inputs: db (required), database (required), password (required), username (required), +1 more.
mysql_change_accessD
MySQL: Change remote access
Inputs: id (required), from (required), type (required), value (required), +1 more.
mysql_change_passwordC
MySQL: Change user password
Inputs: id (required), from (required), type (required), value (required), +1 more.
mysql_get_infoC
MySQL: Get server info
Inputs: from.
mysql_get_remote_accessB
MySQL: Get remote access config
Inputs: no named parameters.
mysql_get_statusB
MySQL: Get server status
Inputs: no named parameters.
mysql_get_variablesC
MySQL: Get variables
Inputs: no named parameters.
mysql_update_remote_accessD
MySQL: Update remote access
Inputs: privilege (required).
mysql_update_variablesD
MySQL: Update variables
Inputs: variables (required).
obtain_sslC
Obtain SSL certificate (Let's Encrypt)
Inputs: ID (required), domains (required), keyType (required), time, +2 more.
operate_fail2banC
Operate Fail2ban (start/stop/restart)
Inputs: operation (required).
operate_fail2ban_sshC
Operate Fail2ban SSH (start/stop/restart)
Inputs: operation (required).
operate_ftpC
Operate FTP (start/stop/restart)
Inputs: operation (required).
operate_node_moduleD
Operate Node module (XPack)
Inputs: id (required), params (required).
partition_diskD
Partition disk
Inputs: path (required), type.
pause_containerC
Pause container
Inputs: id (required).
postgresql_bind_userD
PostgreSQL: Bind/create user
Inputs: name (required), database (required), password (required), username (required), +1 more.
postgresql_change_passwordC
PostgreSQL: Change password
Inputs: id (required), from (required), type (required), value (required), +1 more.
postgresql_change_privilegesD
PostgreSQL: Change privileges
Inputs: id (required), from (required), type (required), value (required), +1 more.
postgresql_list_databasesB
PostgreSQL: List databases
Inputs: no named parameters.
prune_containersC
Prune containers
Inputs: no named parameters.
pull_imageD
Pull image
Inputs: name (required).
push_imageD
Push image
Inputs: name (required).
recover_snapshotD
Recover from snapshot
Inputs: id (required), isNewSnapshot.
recreate_ollama_modelD
Recreate Ollama model (XPack)
Inputs: name (required).
recreate_snapshotD
Recreate snapshot
Inputs: id (required).
redis_change_passwordC
Redis: Change password
Inputs: id (required), value (required).
redis_get_confD
Redis: Get configuration
Inputs: id (required).
redis_get_persistence_confC
Redis: Get persistence config
Inputs: id (required).
redis_get_statusC
Redis: Get status
Inputs: no named parameters.
redis_update_confC
Redis: Update configuration
Inputs: id (required), content.
redis_update_persistence_confD
Redis: Update persistence
Inputs: id (required), save, appendonly, appendfsync.
reduce_recycle_binC
Restore file from recycle bin
Inputs: name (required).
remove_composeD
Remove compose
Inputs: id (required).
remove_containerC
Remove container
Inputs: id (required).
remove_imageD
Remove image
Inputs: id (required).
remove_networkD
Remove network
Inputs: id (required).
remove_volumeD
Remove volume
Inputs: id (required).
rename_containerC
Rename container
Inputs: id (required), name (required).
rename_fileC
Rename file/directory
Inputs: name (required), path (required).
renew_sslC
Renew SSL certificate
Inputs: ID (required).
resolve_sslD
Resolve SSL certificate
Inputs: websiteSSLId (required).
restart_composeD
Restart compose
Inputs: id (required).
restart_containerD
Restart container
Inputs: id (required).
restore_backupD
Restore backup
Inputs: id (required).
save_fileC
Save file content
Inputs: path (required), content (required).
save_imageD
Save image
Inputs: names (required).
scan_clamC
Scan with ClamAV
Inputs: id (required).
search_fail2ban_banned_ipsC
Search banned IPs in Fail2ban
Inputs: page, pageSize.
search_filesC
Search files with keyword
Inputs: path (required), page, search, pageSize.
search_imagesC
Search images
Inputs: no named parameters.
start_composeD
Start compose
Inputs: id (required).
start_containerD
Start container
Inputs: id (required).
stop_composeD
Stop compose
Inputs: id (required).
stop_containerC
Stop container
Inputs: id (required).
sync_ftp_usersC
Sync FTP users
Inputs: no named parameters.
sync_host_ssh_keyD
Sync host SSH key
Inputs: id (required).
sync_ollama_modelsC
Sync Ollama models (XPack)
Inputs: no named parameters.
tag_imageD
Tag image
Inputs: id (required), tag (required), repo (required).
test_composeD
Test compose
Inputs: content (required).
test_host_connectionC
Test host connection
Inputs: id (required).
test_host_connection_by_infoD
Test host connection by info
Inputs: addr (required), name (required), port, user, +3 more.
uninstall_appD
Uninstall app
Inputs: id (required).
uninstall_environmentD
Uninstall environment
Inputs: id (required), type (required).
uninstall_php_extensionD
Uninstall PHP extension
Inputs: id (required), extension (required).
unmount_diskD
Unmount disk
Inputs: mountPoint (required).
unpause_containerD
Unpause container
Inputs: id (required).
update_appD
Update app
Inputs: id (required).
update_backup_accountD
Update backup account
Inputs: name (required), type (required), vars (required), isDefault.
update_clam_configD
Update ClamAV config
Inputs: id (required), name, path, description.
update_clam_fileD
Update ClamAV file config
Inputs: content (required).
update_clam_statusC
Update ClamAV status
Inputs: status (required).
update_composeD
Update compose
Inputs: id (required), content (required).
update_containerD
Update container
Inputs: id (required), config (required).
update_dashboard_memoD
Update dashboard memo
Inputs: content (required).
update_deviceD
Update device configuration
Inputs: conf (required).
update_device_by_fileC
Update device configuration by file
Inputs: content (required).
update_device_hostsD
Update device hosts
Inputs: hosts (required).
update_device_passwordD
Update device password
Inputs: newPass (required), oldPass (required).
update_device_swapD
Update device swap
Inputs: swap (required).
update_fail2ban_confD
Update Fail2ban configuration
Inputs: key (required), value (required).
update_fail2ban_conf_by_fileC
Update Fail2ban configuration by file content
Inputs: content (required).
update_ftp_userC
Update FTP user
Inputs: id (required), path, password, description.
update_hostD
Update host
Inputs: id (required), addr, name, port, +3 more.
update_host_groupD
Update host group
Inputs: id (required), groupID (required).
update_host_group_by_idD
Update host group
Inputs: id (required), name, isDefault.
update_host_ssh_keyD
Update host SSH key
Inputs: id (required), authMode (required), password, privateKey.
update_httpsD
Update HTTPS configuration
Inputs: type (required), enable (required), websiteId (required), hsts, +7 more.
update_monitor_settingD
Update monitor setting
Inputs: setting (required).
update_nginx_confC
Update Nginx configuration
Inputs: id (required), content (required).
update_openresty_by_fileC
Update OpenResty config by file (XPack)
Inputs: content (required).
update_openresty_confC
Update OpenResty configuration (XPack)
Inputs: params (required).
update_openresty_moduleD
Update OpenResty module (XPack)
Inputs: params (required).
update_php_confC
Update PHP config
Inputs: id (required), content (required).
update_php_conf_fileC
Update PHP config file
Inputs: id (required), type (required), content (required).
update_php_versionD
Update PHP version
Inputs: id (required), version (required).
update_settingsD
Update settings
Inputs: settings (required).
update_snapshot_descriptionD
Update snapshot description
Inputs: id (required), description (required).
update_ssh_configD
Update SSH config
Inputs: config (required).
update_websiteD
Update website
Inputs: site (required).
update_website_domainD
Update website domain
Inputs: id (required), websiteId (required), port, domain.
upgrade_containerD
Upgrade container
Inputs: id (required), image (required).
upload_sslC
Upload SSL certificate
Inputs: cert (required).
wget_fileC
Download from URL
Inputs: url (required), path (required), ignoreCertificate.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 257 tools
The set contains many overlapping and near-duplicate tools, e.g. list_containers vs list_containers_simple, get_container vs inspect_container, get_system_info vs get_system_monitor, and several MySQL/PostgreSQL/Redis-prefixed variants. An agent would struggle to reliably choose the correct tool for a given intent.
Most tools use snake_case and follow a verb_noun style, but conventions are mixed across service-specific prefixes (mysql_, postgresql_, redis_), generic DB operations, and verbs such as operate_, exec_, wget_, sync_, and test_. It is readable but not uniformly predictable.
257 tools is an extreme mismatch for a single MCP server and far exceeds practical selection and context limits. Even if each tool maps to an API endpoint, the count makes the surface unwieldy for an agent.
The server covers an unusually broad range of 1Panel administration areas, including Docker, websites, SSL, databases, files, backups, firewall, hosts, snapshots, and security tools. Some minor lifecycle gaps exist, such as cronjob update/get and firewall rule update, but core operations are well represented.
Maintenance
Related MCP Connectors
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Termalin's hosted MCP server. Claude, ChatGPT or any MCP client runs commands, moves files over SFTP, queries databases and reads server metrics and monitoring alerts on your servers, keylessly through Termalin Connectors: no SSH key is handed over and no inbound port is opened. Per-host command policy and an audit log. Needs a termal.in Pro or Team account (new accounts start with a 14-day Pro trial).
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to manage server infrastructure through the 1Panel API, including Docker containers, databases, and system monitoring. It provides tools for website management, file operations, and application deployment via natural language commands.1535 npmMIT
- AlicenseBqualityCmaintenanceMCP server for EasyPanel that enables AI agents to manage servers, projects, services, databases, and domains via 40 curated tools or raw tRPC access to all 347 API procedures.4249 npm4MIT
- AlicenseBqualityCmaintenanceMCP Server for full Easypanel control via Claude Code, Cursor, and Claude Desktop. Provides 37 tools for deploy, logs, env vars, domains, databases, and monitoring with built-in safety guards.57309 npm4MIT
- AlicenseNot gradedqualityDmaintenanceFull-featured MCP server for 1Panel server management panel. Provides 490+ tools for managing websites, databases, containers, files, and more through natural language.MIT