krexel-mcp

Name: krexel-mcp
Author: Syfer-web

本地服务

github.com/Syfer-web云与基础设施014 周前更新

代码仓库

关于 krexel-mcp

krexel-mcp 是 Krexel 的 MCP 服务，可通过兼容 MCP 的 AI 客户端部署和编辑静态网站。它提供文件操作、部署管理、回滚、环境变量及状态查询工具。

主要功能

01部署构建好的网站目录
02编辑已部署文件
03查看和读取网站文件
04列出部署记录并查看日志
05回滚到先前部署
06管理环境变量和状态

适用场景

01从 AI 客户端发布构建好的静态网站
02让 AI 检查并修改已部署文件
03更改后恢复到先前部署

MCP 相关

向 MCP 客户端提供九个 Krexel 工具，并通过标准工具发现机制公开。工具涵盖部署、文件操作、日志、回滚、环境变量和账户状态。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "syfer-web-krexel": {
      "command": "npx",
      "args": [
        "-y",
        "krexel-mcp"
      ]
    }
  }
}

启动命令npx -y krexel-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmkrexel-mcp0.3.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
domain	string	是	要关联的自定义域名（例如 shop.example.com）。
folder	string	是	已构建站点目录的绝对路径或以 ~ 开头的相对路径。
framework	enum	否	构建框架提示。默认值 'auto' 会根据 package.json 自动检测。auto \| nextjs \| astro \| vite \| static

详细介绍

krexel-mcp

通过任何支持模型上下文协议的 AI 助手，发布并编辑静态网站。

krexel-mcp 是 Krexel 的官方 MCP 服务——一个“让你的 AI 发布并编辑线上网站”的 API。将任何兼容 MCP 的客户端（Claude Desktop、Cursor、Windsurf、VS Code）连接到此服务，助手就能通过对话部署、列出、编辑、回滚和检查网站。

快速开始

将 krexel-mcp 添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "krexel": {
      "command": "npx",
      "args": ["-y", "krexel-mcp"],
      "env": {
        "KREXEL_API_URL": "https://api.krexel.com",
        "KREXEL_API_KEY": "krx_live_••••••••••••••••",
        "KREXEL_MASTER_KEY": "<your-32-byte-hex-key>"
      }
    }
  }
}

重启客户端。助手现在可以使用九种 Krexel 工具。

工具

工具	功能
`ship_site`	上传构建好的网站文件夹。返回 `deploy_id` 和预览 URL。
`edit_file`	修改已部署的网站（创建 / 替换 / 全部替换 / 删除）。一次部署计为 0.1 次。
`list_files`	列出已部署网站中的文件（路径 + 大小 + sha256）。
`read_file`	读取已部署网站中单个文件的内容。
`list_deploys`	列出本地状态中的近期部署。可选按域名筛选。
`get_logs`	获取某次部署的构建日志。
`rollback`	将之前的部署设为当前稳定版本。
`set_env`	为域名加密并持久保存环境变量（AES-256-GCM）。
`get_status`	返回账户、部署次数、套餐和状态目录。

对话式编辑流程

AI 调用 list_files(deploy_id) 查看网站上有哪些文件。
AI 调用 read_file(deploy_id, path) 读取它想修改的文件。
AI 自行生成新内容，然后调用 edit_file(deploy_id, op: "replace", file, find, value, message)。
Krexel 将补丁作为一次新的部署发布——约 8 秒后上线，计入客户配额的 0.1 次部署。系统会返回新的 deploy_id 和 parent_deploy_id，以便 AI 在此基础上继续修改。

AI 是大脑。Krexel 是双手。

所有工具都接受普通 JSON 参数并返回 JSON。工具架构可通过标准 MCP tools/list 请求查询。

配置

环境变量	必需	默认值	说明
`KREXEL_API_URL`	否	`https://api.krexel.com`	Krexel 编排器 API 的基础 URL。
`KREXEL_API_KEY`	否*	`~/.krexel/auth.json`	账户 API 密钥。每次 API 调用都会将其转发为 `Authorization: Bearer **`。除非已通过 `krexel login` 保存，否则必需。
`KREXEL_MASTER_KEY`	是*	—	用于加密环境变量的 32 字节十六进制字符串。*`set_env` 必需。