@kuailian/mcp-server

快链 MCP Server

在 Cursor / Claude Code 里一句话发布网页到 快链。

配置

• 打开 https://link.3ceng.cn ，登录后切到 MCP Tab，生成 API Key
• 把下面片段写入 Cursor 的 mcp.json（Key 只显示一次，请妥善保存）

{
  "mcpServers": {
    "kuailian": {
      "command": "npx",
      "args": ["-y", "@kuailian/mcp-server"],
      "env": {
        "KUAILIAN_API_KEY": "kl_live_xxx"
      }
    }
  }
}

不用手动安装，也不用启动任何服务——Cursor 会在需要时把它当子进程拉起来，用完自动结束。

需要联网：协议走本地 stdio，但发布必须调用快链 API。

环境变量

变量	必填	默认值
KUAILIAN_API_KEY	是	—
KUAILIAN_API_URL	否	https://link.3ceng.cn/api
KUAILIAN_SITE_URL	否	https://link.3ceng.cn

本地开发

cd mcp-server && npm i && npm run dev

调试时把 mcp.json 的 command 换成 npx、args 换成 ["-y", "tsx", "<仓库内 mcp-server/src/index.ts 的绝对路径>"]，并把两个 URL 变量指向本地服务。

Tools

Tool	作用
kuailian_publish_html	发布单页 HTML
kuailian_update_page	更新已有代码站
kuailian_publish_dir	打包发布本地静态目录（zip）
kuailian_update_dir	更新文件夹站
kuailian_list_pages	我的快链列表
kuailian_get_page	项目详情
kuailian_delete_page	删除（进回收站）
kuailian_get_quota	配额 / 会员状态
kuailian_get_stats	访问统计（会员）

统一返回短链：https://link.3ceng.cn/view/{shortId}。

Resources

• kuailian://docs/limits
• kuailian://docs/kv-api
• kuailian://docs/publish-guide

配额超额

返回结构化错误，含 upgrade_url（?from=mcp），Agent 会引导用户去会员页升级。MCP 不能代付。