dpanel-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DPANEL_HOST | Yes | DPanel 访问地址 (DPanel access URL), e.g. http://127.0.0.1:8807 | |
| DPANEL_PASSWORD | Yes | DPanel 密码 (DPanel password) | |
| DPANEL_USERNAME | Yes | DPanel 管理员用户名 (DPanel administrator username), e.g. admin | |
| DPANEL_MCP_PROFILE | No | 能力分级 (capability profile): read-only | read-write | admin | |
| DPANEL_MCP_HTTP_HOST | No | streamable-http 模式下的监听地址 (HTTP bind host in streamable-http mode), e.g. 0.0.0.0 | |
| DPANEL_MCP_HTTP_PORT | No | streamable-http 模式下的监听端口 (HTTP port in streamable-http mode), e.g. 8090 | |
| DPANEL_MCP_TRANSPORT | No | 传输模式 (transport mode): stdio or streamable-http | |
| DPANEL_MCP_AUTH_TOKEN | No | streamable-http 模式下 MCP 端点的访问门禁 token (optional access token for the MCP endpoint in streamable-http mode; clients must send Authorization: Bearer <token>) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| dpanel_system_infoA | DPanel 系统信息:版本、运行环境、Docker 环境状态、数据挂载。 |
| dpanel_system_usageB | DPanel 所在主机资源使用情况(CPU/内存/磁盘/面板占用)。 |
| dpanel_system_stat_listC | DPanel 多主机统计列表。 |
| dpanel_setting_getC | 读取 DPanel 配置项。group_name 如 setting;name 如 DPanelInfo/docker。 |
| dpanel_log_listD | DPanel 系统日志列表。 |
| dpanel_env_listA | 列出 Docker 环境(多主机),含当前环境。 |
| dpanel_env_detailD | Docker 环境详情。 |
| dpanel_env_switchC | 切换当前 Docker 环境(多主机)。 |
| dpanel_env_createC | 创建 Docker 环境(连接远程 Docker host)。 |
| dpanel_env_deleteA | 删除 Docker 环境(破坏性,需 confirm=true)。 |
| dpanel_container_listA | 容器列表(含状态、镜像、名称、网络)。可按 md5(容器ID)或站点名过滤。注意:API 不分页,返回全量。 |
| dpanel_container_detailB | 容器详情。md5 为容器 ID(完整或前缀)。 |
| dpanel_container_statC | 容器资源统计(CPU/内存/网络 IO)。id 为容器 ID。 |
| dpanel_container_processB | 容器内进程列表。id 为容器 ID。 |
| dpanel_container_statusC | 容器生命周期控制:operate ∈ start|stop|restart|pause|unpause。 |
| dpanel_container_updateC | 更新容器配置(重启策略/环境变量/端口等,option 结构与面板一致)。 |
| dpanel_container_copyC | 复制容器。copy_name 为新容器名。 |
| dpanel_container_exportC | 导出容器为镜像 tar。 |
| dpanel_container_commitC | 将容器提交为新镜像。 |
| dpanel_container_check_portC | 检查主机端口占用情况。 |
| dpanel_container_deleteB | 删除容器(破坏性,需 confirm=true)。可选同时删除镜像/卷/链接。 |
| dpanel_container_pruneA | 清理停止的容器(破坏性,需 confirm=true)。 |
| dpanel_container_upgrade_listB | 容器升级检查列表(含可升级镜像 digest 对比)。 |
| dpanel_container_upgrade_checkC | 检查单个容器镜像更新。container_id 为容器 ID。 |
| dpanel_container_upgradeB | 升级容器(拉新镜像并重建,保留配置)。image_tag 留空用原镜像。 |
| dpanel_container_upgrade_ignoreC | 忽略容器升级(加入忽略清单)。 |
| dpanel_container_backup_listC | 容器备份列表。 |
| dpanel_container_backup_detailC | 备份详情。id 为备份记录 id。 |
| dpanel_container_backup_createB | 创建容器备份快照。id 为容器 ID。 |
| dpanel_container_backup_deleteA | 删除备份(破坏性,需 confirm=true)。 |
| dpanel_container_backup_restoreB | 从备份恢复容器(破坏性,需 confirm=true)。 |
| dpanel_compose_listA | Compose 项目列表(含运行容器概览)。注意:dangling 项目 id=0,仅可查看。 |
| dpanel_compose_taskB | Compose 项目详情与任务状态。id 为项目 id(数字字符串,列表返回)。 |
| dpanel_compose_logB | Compose 项目日志。line_total ∈ 50|100|200|500|1000|5000|-1。download=true 返回全量文本。 |
| dpanel_compose_get_from_uriC | 从 URL 拉取 compose 文件内容。 |
| dpanel_compose_get_from_gitC | 从 Git 仓库拉取 compose 文件。 |
| dpanel_compose_createA | 创建/更新 compose 项目。compose_type ∈ text|remoteUrl|outPath(storagePath/store 不可手动建)。 yaml 为完整 docker-compose 内容(text 类型)。传 id 为更新。返回项目 id。 |
| dpanel_compose_deployC | 部署/更新 compose 项目。id 为项目 id。deploy_service_name 可指定只部署部分服务。 |
| dpanel_compose_container_ctrlC | Compose 项目控制:op ∈ start|stop|restart|pause|unpause|ls。 |
| dpanel_compose_destroyA | 销毁 compose 项目(破坏性,需 confirm=true)。delete_data=true 同时删除项目记录; delete_path=true 删除 compose 文件目录。 |
| dpanel_image_listC | 镜像列表。 |
| dpanel_image_detailB | 镜像详情。md5 为镜像 sha256 digest(如 sha256:abc123...)。 |
| dpanel_image_tag_searchC | 在 Docker Hub 搜索镜像。 |
| dpanel_image_tag_addB | 为镜像添加 tag。md5 为镜像 digest,tag 形如 repo:tag。 |
| dpanel_image_tag_syncB | 同步镜像 tag。sync_type ∈ pull|push。tag 形如 repo:tag。 |
| dpanel_image_tag_push_batchC | 批量推送镜像 tag 到远程仓库。 |
| dpanel_image_import_by_image_tarB | 导入镜像 tar(从 DPanel 存储目录)。 |
| dpanel_image_tag_deleteA | 删除镜像 tag(破坏性,需 confirm=true)。 |
| dpanel_image_deleteB | 删除镜像(破坏性,需 confirm=true)。md5 为镜像 sha256 digest 数组。 |
| dpanel_image_pruneA | 清理悬空镜像(破坏性,需 confirm=true)。 |
| dpanel_image_build_listC | 镜像构建任务列表。 |
| dpanel_image_build_detailD | 镜像构建任务详情。 |
| dpanel_image_build_createC | 创建镜像构建任务(从 Dockerfile)。tags 为目标镜像 tag。 |
| dpanel_image_build_runD | 执行镜像构建任务。 |
| dpanel_image_build_deleteB | 删除镜像构建任务(破坏性,需 confirm=true)。 |
| dpanel_image_build_pruneB | 清理构建缓存(破坏性,需 confirm=true)。 |
| dpanel_network_listC | 网络列表。 |
| dpanel_network_detailD | 网络详情。 |
| dpanel_network_container_listC | 网络上的容器列表。 |
| dpanel_network_createC | 创建网络。driver ∈ bridge|macvlan|ipvlan|overlay。 |
| dpanel_network_connectC | 将容器接入网络。 |
| dpanel_network_disconnectC | 将容器从网络断开。 |
| dpanel_network_deleteA | 删除网络(破坏性,需 confirm=true)。 |
| dpanel_network_pruneA | 清理未使用网络(破坏性,需 confirm=true)。 |
| dpanel_volume_listB | 卷列表(含使用状态)。 |
| dpanel_volume_detailD | 卷详情。 |
| dpanel_volume_createD | 创建卷。 |
| dpanel_volume_deleteA | 删除卷(破坏性,需 confirm=true)。name 为卷名数组。 |
| dpanel_volume_pruneA | 清理未使用卷(破坏性,需 confirm=true)。 |
| dpanel_explorer_listC | 文件列表。mount_point ∈ volume:<卷名> | container:<容器ID> | docker:<环境名>。 |
| dpanel_explorer_contentC | 读取文件内容。 |
| dpanel_explorer_statD | 文件 stat 信息。 |
| dpanel_explorer_path_sizeC | 目录大小统计。 |
| dpanel_explorer_exportD | 导出文件(打包)。 |
| dpanel_explorer_importC | 导入文件。file_list: [{name, path}]。 |
| dpanel_explorer_unzipD | 解压压缩文件。 |
| dpanel_explorer_mkdirC | 新建目录。 |
| dpanel_explorer_permissionC | 修改文件权限/所有者。mod 如 644;owner 为用户名。 |
| dpanel_explorer_deleteC | 删除文件(破坏性,需 confirm=true)。 |
| dpanel_cron_listC | 计划任务列表。 |
| dpanel_cron_detailC | 计划任务详情。 |
| dpanel_cron_log_listD | 计划任务执行日志。 |
| dpanel_cron_templateB | 计划任务模板列表(10 个官方模板)。 |
| dpanel_cron_createA | 创建计划任务。trigger_type ∈ cron|event|manual。spec 为 cron 表达式(trigger=cron 时)。 option 结构参考 dpanel_cron_template 返回的模板。 |
| dpanel_cron_run_onceB | 立即执行一次计划任务。 |
| dpanel_cron_deleteA | 删除计划任务(破坏性,需 confirm=true)。 |
| dpanel_cron_prune_logB | 清理计划任务日志(破坏性,需 confirm=true)。 |
| dpanel_store_listC | 应用商店应用列表。 |
| dpanel_store_syncD | 同步应用商店数据。 |
| dpanel_store_deployC | 从应用商店部署应用。store_id 为商店应用 id。 |
| dpanel_store_createC | 添加应用商店源。 |
| dpanel_store_deleteB | 删除应用商店源(破坏性,需 confirm=true)。 |
| dpanel_registry_listC | 镜像仓库列表。 |
| dpanel_registry_detailC | 镜像仓库详情。 |
| dpanel_registry_createC | 添加镜像仓库。 |
| dpanel_registry_deleteA | 删除镜像仓库(破坏性,需 confirm=true)。 |
| dpanel_notice_listC | 通知列表(操作事件流水)。 |
| dpanel_notice_unreadC | 未读通知(action=new)。 |
| dpanel_notice_deleteB | 删除通知(破坏性,需 confirm=true)。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 99 tools
Tools are mostly separated by dpanel_<domain>_<action>, and descriptions make the intended operation clear. A few pairs still overlap, such as compose_create vs compose_deploy, image_tag_sync vs image_tag_push_batch, and container_upgrade_list/check/upgrade, so some care is needed during selection.
All names use the dpanel_ prefix and snake_case, with a predictable domain-action pattern. Minor deviations exist, including noun-only names like system_info and container_status, and varied action placement like get_from_uri, but there is no chaotic convention mixing.
99 tools far exceeds the 50+ extreme-mismatch threshold for an MCP tool set. Even for a broad Docker panel domain, this creates a very high selection and maintenance burden.
Coverage is broad across containers, compose, images, networks, volumes, files, cron, store, registry, system, and notices, including lifecycle, backup, and upgrade operations. However, common Docker operations like container logs and exec are absent, and settings/cron update operations are missing.