该项目是基于 Model Context Protocol (MCP) 开发的一个后端服务,旨在通过标准化的协议接口,帮助 AI 客户端(如 Cursor IDE)自动化部署静态网站到 1Panel 服务器。

主要功能点

  • 自动化将本地静态网站文件部署到 1Panel。
  • 支持在 1Panel 中自动创建新的网站。
  • 上传文件并提供统计信息。

安装步骤

该项目通常通过兼容 MCP 协议的客户端(如 Cursor IDE)来启动和管理。你需要确保已安装 Node.js 环境,并且该项目已发布到 npm 或可被 npx 访问。

服务器配置

MCP 客户端需要配置如何启动并连接到这个 MCP 服务器。以下是一个示例配置,通常保存在客户端的特定配置文件中(例如 Cursor IDE 的 '.cursor/mcp.json'):

{
  "mcpServers": {
    "1panel-mcp": { // 给这个 MCP 服务器起一个名字,供客户端识别
      "command": "npx", // 启动服务器进程的命令
      "args": [         // 传递给 command 的参数
        "-y",         // npx 参数,用于自动同意安装包
        "1panel-mcp"  // 要运行的 npm 包名,即这个 MCP 服务器的实现
      ],
      "env": {        // 配置服务器进程运行时的环境变量
        "ONEPANEL_BASE_URL": "<你的 1Panel 面板地址,例如 http://your-panel.com>", // 1Panel API 的基础 URL
        "ONEPANEL_API_KEY": "<你的 1Panel API Key>" // 访问 1Panel API 的密钥,确保具有足够的权限
      }
    }
  }
}

将以上配置(填充 '<>' 部分)添加到你的 MCP 客户端的配置文件中。

基本使用方法

在配置好 MCP 服务器的 AI 客户端(如 Cursor IDE)中,通过聊天窗口向 AI 发送指令,触发网站部署工具。该服务器提供了一个名为 'deploy_website' 的工具。

你可以使用类似于以下的自然语言指令:

  • 'Deploy to 1Panel with domain=yourdomain.com'
  • 'Deploy website to 1Panel server, domain: yourdomain.com'

客户端会解析你的指令,识别出需要调用 'deploy_website' 工具,并根据指令内容提取参数(如 'domain'),然后通过 MCP 协议将请求发送给配置好的 '1panel-mcp' 服务器。服务器执行部署操作后,会将结果返回给客户端。

信息

分类

开发者工具