用途:本 Skill 面向需要通过 API 操作 1Panel 开源面板的 Agent 与用户,提供 1Panel API 文档加零依赖 Node.js 工具层,用工具调用替代临时拼写 curl。仓库含 tools/1panel-tool.js(命令行 / JSON tool-call 运行器)、tools/1panel-mcp.js(MCP stdio server)、tools/1panel-lib.js(Token 计算、API 请求、端点索引解析)及 docs/SKILL-*.md 分模块端点文档。
主要能力:MCP 暴露 onepanel_endpoint_search(搜索端点索引)、onepanel_modules(列出 API 模块)、onepanel_get、onepanel_post、onepanel_request(任意方法)五个 tools;覆盖 Apps、Websites、Containers、Databases、Files、Backups、Cronjobs、Runtimes、Hosts、Settings 等模块。
使用方式:需 Node.js 18+(使用内置 fetch,无需 npm 依赖)。配置环境变量 ONEPANEL_BASE_URL、ONEPANEL_API_KEY,自签 HTTPS 可设 ONEPANEL_INSECURE=true。API Key 在面板「设置」→「API 密钥」创建。CLI 示例:node tools/1panel-tool.js get /containers/status;node tools/1panel-tool.js post /containers/search --body '{"page":1,"pageSize":20}';亦支持 tool-call 模式。MCP 配置需在 mcpServers 中指定 node 及 1panel-mcp.js 绝对路径,并注入上述环境变量。认证由工具内部完成,timestamp 取当前 Unix 秒,token = md5("1panel" + apiKey + timestamp),请求头带 1Panel-Token 与 1Panel-Timestamp。返回统一 JSON,含 ok、status、statusText、url、data。
适用场景与限制:适合借 MCP 或 CLI 管理 1Panel 面板资源的 Agent 工作流;对删除、停止服务、重启服务、覆盖配置、清理文件等危险操作应先向用户确认影响范围。仓库未提供收费、价格等信息。