Skip to main content
Glama

1Panel MCP Server — V1 版

1Panel API License Node

⚠️ 这是 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 实际写法

容器启停

POST /containers/operate {id, operation}

POST /containers/operate {names: [], operation}

删除容器

POST /containers/del

POST /containers/operate {operation: "remove"}

容器详情

POST /containers/info {id}

POST /containers/info {name}

拉取镜像

POST /containers/image/pull {name}

POST /containers/image/pull {imageName}

容器日志

GET /containers/search/log

POST /containers/download/log(UI 那条是 WebSocket 流,裸 GET 必 400)

Docker 状态

GET /containers/status

GET /containers/docker/status

同时修复了上游的若干实现缺陷(详见 修复记录)。


特性

  • 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 build

2. 获取 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-key

4. 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 监听全部网卡(那样局域网也能访问,请自行确认网络环境可信)。

端点:

端点

方法

说明

/mcp

POST / GET / DELETE

Streamable HTTP(推荐)

/sse + /messages

GET / POST

旧版 HTTP+SSE 传输(兼容老客户端)

/health

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 里做了这些事:

项

配置

开机自启

WantedBy=multi-user.target + 脚本里的 enable

崩溃重启

Restart=on-failure / RestartSec=5

日志

StandardOutput=journal、SyslogIdentifier=1panel-mcp-v1

资源限制

MemoryHigh=512M、MemoryMax=1G、CPUQuota=200%、TasksMax=128

优雅停止

KillSignal=SIGTERM、TimeoutStopSec=15(HTTP 入口会先关掉所有会话)

Tailscale

After= / Wants=tailscaled.service,避免开机时地址还没就绪

重启频率

StartLimitIntervalSec=300 / StartLimitBurst=30,等待网络期间不会被判为反复失败

加固

CapabilityBoundingSet=(清空)、ProtectSystem=strict、ProtectHome=read-only、PrivateTmp=、PrivateDevices=、NoNewPrivileges= 等

服务以安装目录的属主身份运行(sudo 安装时取 $SUDO_USER),因此能读到权限 600 的 .env.local。注意监听地址若绑定 Tailscale 虚拟 IP,务必先用 tailscale ip -4 确认该地址, 否则 listen() 会返回 EADDRNOTAVAIL(systemd 下会自动重试)。

环境变量

变量

说明

默认

ONEPANEL_HOST

1Panel 地址

localhost

ONEPANEL_PORT

1Panel 端口

8080

ONEPANEL_API_KEY

面板 API 密钥(未设置时回退到 MCP_TOKEN)

—

ONEPANEL_PROTOCOL

http 或 https

http

MCP_TOKEN

HTTP 访问令牌;也用作面板密钥回退

—

MCP_HOST

HTTP 监听地址(serve)

127.0.0.1

MCP_PORT

HTTP 监听端口(serve)

8790

MCP_PATH

Streamable HTTP 路径

/mcp

MCP_MAX_BODY

请求体上限(字节)

33554432

配置示例见 .env.example。


两个密钥的分工

本服务涉及两个不同的密钥,职责完全分离 —— 客户端设备只需要其中一个:

面板 API 密钥

MCP 访问令牌

变量

ONEPANEL_API_KEY

MCP_TOKEN

作用

服务端调用 1Panel /api/v1/* 时的身份

客户端连接 MCP 端点时的身份

配在哪

只在本机 .env.local

服务器 + 每台客户端

怎么来

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}"
      }
    }
  }
}

三个容易踩的坑:

  1. oauth 必须显式设为 false。 本服务用静态令牌,没有授权服务器。

  2. {env:VAR} 在变量未设置时会替换成空字符串 —— 配置看起来完全正常, 但实际发出的是 Authorization: Bearer ,结果是 401。用这种方式就必须确保 OpenCode 的进程环境里真的有这个变量。

  3. 不要照抄文档里的占位符。 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 无关。


故障排查

现象

原因

处理

客户端连接返回 401,日志写「令牌不匹配」

客户端配置里的令牌不对(常见:把文档占位符原样抄了,或 {env:VAR} 的变量没设)

日志会区分「未携带令牌」和「令牌不匹配」;按 两个密钥的分工 确认客户端用的是 MCP_TOKEN

日志里出现 /.well-known/oauth-*、/register 请求

客户端在走 OAuth 发现流程,说明它收到的令牌没通过校验

本服务不支持 OAuth,这些路径返回 404;按上一条检查令牌

重启服务后所有工具都报 401 API 接口密钥错误

改了 MCP_TOKEN 却没设 ONEPANEL_API_KEY,回退逻辑把这个值当成了面板密钥

两个都要设,见 两个密钥的分工;启动横幅的「面板密钥来源」会显示是 ONEPANEL_API_KEY 还是 MCP_TOKEN(回退)

401 API 接口密钥错误(其它情况)

把 API Key 当成了 Token

确认用的是 md5 签名(本 server 已自动处理)

调用 API 接口 IP 不在白名单

调用方 IP 未加白

面板 → API 接口 → 白名单加上该 IP

返回 HTML / Unexpected token '<'

路径在 v1 不存在,落到了安全入口守卫页

说明该端点是 v2 专有;本项目已改为抛出明确错误

API 接口禁止访问

该路由未开放给外部 API

属面板侧限制,无法绕过

连接被拒

面板端口不对

用 1pctl user-info 或面板设置确认端口


修复记录

相对上游 1panel-mcp 修正的问题:

  1. 命名冲突导致 HTTP 方法被覆盖:ContainerAPI.get(id) 覆盖了 BaseAPI.get(path), 导致 getStatus() / getStats() / getLogs() 实际发出 POST /containers/info,把 URL 当成容器名。 改用 super.get()。(该缺陷在上游 v2 版本中同样存在)

  2. 业务错误被当成成功:1Panel 用 HTTP 200 + body.code 表达错误,原实现只检查 HTTP 状态码。

  3. HTML 守卫页被当作 JSON 解析,报出难以理解的 Unexpected token '<'。

  4. 日志端点形态错误:v1 外部 API 应使用 POST /containers/download/log。

  5. 生命周期操作字段错误:v1 是 {names: [], operation} 而非 {id, operation}。

  6. 移除 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

MIT

Available Tools

257 tools
apply_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

    D1.9/5.0

    Scored across 257 tools

    Disambiguation1/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      15
      35 npm
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP 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.
      42
      49 npm
      4
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP 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.
      57
      309 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Full-featured MCP server for 1Panel server management panel. Provides 490+ tools for managing websites, databases, containers, files, and more through natural language.
      MIT