返回 MCP 目录
public公开dns本地运行

webflow_mcp-server

一个基于Node.js的Webflow MCP服务器,通过Webflow JavaScript SDK实现模型上下文协议,使AI代理能够与Webflow API交互。

article

README

🚀 Webflow MCP 服务器

Webflow MCP 服务器基于 Node.js 实现,遵循 Webflow 模型上下文协议 (MCP)。它借助 Webflow JavaScript SDK,让 AI 代理能够和 Webflow API 进行交互。若想了解更多信息,可访问 Webflow 的 开发者文档

npm 盾牌 fern 盾牌

🚀 快速开始

克隆仓库并安装依赖项

git clone git@github.com:webflow/mcp-server.git
cd mcp-server
npm install

配置 Webflow 令牌

创建一个 .env 文件,添加以下内容并将 <YOUR_WEBFLOW_TOKEN> 替换为您的实际令牌:

# .env
WEBFLOW_TOKEN=<YOUR_WEBFLOW_TOKEN>

启动开发服务器

npm start

✨ 主要特性

本服务器支持 AI 代理与 Webflow API 交互,提供了丰富的站点管理和 CMS 管理命令,方便对 Webflow 站点进行操作。

📦 安装指南

先决条件

  • 操作系统:支持 Node.js 的任意操作系统(推荐使用 Linux 或 macOS)
  • Node.js:版本 14 或更高
  • npm:随 Node.js 安装的默认包管理器
  • Webflow 账户:必须拥有 Webflow 帐户以获取 API 访问令牌

💻 使用示例

基础用法

以下是一些常见的站点管理和 CMS 管理命令示例:

站点管理

sites - list;           # 列出所有站点
sites - get;            # 获取站点详细信息
sites - publish;        # 发布站点更改

页面管理

pages - list;           # 列出所有页面
pages - get - metadata; # 获取页面元数据
pages - update - page - settings; # 更新页面设置
pages - get - content;  # 获取页面内容
pages - update - static - content; # 更新静态内容

CMS 管理 - 集合相关

collections - list;         # 列出所有集合
collections - get;          # 获取集合详细信息
collections - create;       # 创建新集合
collection - fields - create - static; # 创建静态字段
collection - fields - create - option; # 创建选项字段
collection - fields - create - reference; # 创建引用字段
collection - fields - update; # 更新自定义字段
collections - items - create - item - live; # 创建实时项
collections - items - update - items - live; # 更新实时项
collections - items - list - items; # 列出集合项
collections - items - create - item; # 创建新项(阶段)
collections - items - update - items; # 更新项(阶段)
collections - items - publish - items; # 发布项

高级用法

在开发模式下运行服务器,步骤与快速开始一致:

  1. 克隆仓库并安装依赖项:
git clone git@github.com:webflow/mcp-server.git
cd mcp-server
npm install
  1. 配置 Webflow 令牌:
# .env
WEBFLOW_TOKEN=<YOUR_WEBFLOW_TOKEN>
  1. 启动开发服务器:
npm start

📚 详细文档

故障排除

常见问题

  • 问题:无法获取 Webflow API 访问令牌
    解决方案:确保您已登录到 Webflow 并在 开发者文档 中创建了项目,然后按照指南生成访问令牌。

  • 问题:服务器启动失败
    解决方案:检查 .env 文件是否存在于项目根目录,并确保 WEBFLOW_TOKEN 值正确无误。另外,确认所有依赖项均已安装。

Webflow 开发资源

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端