Netlify MCP 服务器

模型上下文协议 (MCP) 服务器，提供通过 Netlify CLI 与 Netlify 交互的工具和资源。该服务器支持部署站点、管理环境变量、构建等功能，并与 Netlify CLI v19.1.5 兼容。

最近更改（2025 年 4 月 8 日）

• **兼容性更新：**已验证工具与 Netlify CLI v19.1.5 的兼容性。
• **移除了不支持的工具/资源：**移除了与不可用的 CLI 命令组相关的功能： dns 、 forms 、 plugins 、 hooks 、 deploys 。诸如functions:delete 、 functions:invoke和sites:get特定命令也被移除，因为它们不可用或与通过 MCP 服务器进行非交互式使用不兼容。
• **站点上下文解决方法：**更新需要站点上下文的工具（如env:* 、 logs:function 、 build 、 trigger-build ）以通过NETLIFY_SITE_ID环境变量传递siteId ，因为此 CLI 版本中的这些命令不支持--site标志。

功能（兼容 Netlify CLI v19.1.5）

• 部署和管理站点（ deploy-site 、 build-site 、 trigger-build 、 link-site 、 unlink-site 、 get-status 、 create-site 、 delete-site ）
• 管理环境变量（ set-env-vars 、 get-env-var 、 unset-env-var 、 import-env 、 clone-env-vars ）
• 获取函数日志（ get-logs ）
• 通过资源访问站点数据（ list-sites 、 list-functions 、 list-env-vars ）
• 全面的错误处理
• 使用 Zod 进行类型安全参数验证

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Netlify MCP 服务器：

手动安装

1. 克隆存储库（如果尚未完成）。
2. 安装依赖项：
   npm install
3. 构建服务器：
   npm run build
4. 确保已安装 Netlify CLI（v19.1.5 或兼容）：
   # Example global install: npm install -g netlify-cli@19.1.5

验证

此 MCP 服务器与 Netlify CLI 交互，需要使用您的 Netlify 帐户进行身份验证。由于服务器以非交互方式运行，因此您必须使用个人访问令牌 (PAT) 。

1. 生成 PAT：
   • 转到您的 Netlify 用户设置 > 应用程序 > 个人访问令牌（直接链接）。
   • 选择**“新建访问令牌”** 。
   • 给出其描述（例如“MCP 服务器令牌”）。
   • 设置到期日期。
   • 选择生成令牌。
   • 立即复制令牌并安全存储。
2. **配置令牌：**您需要将此令牌作为NETLIFY_AUTH_TOKEN环境变量提供给 MCP 服务器。请将其添加到 MCP 设置文件中服务器配置的env部分（见下文）。

**注意：**使用netlify login不适合此服务器，因为它需要交互式浏览器身份验证。

配置

将以下配置添加到您的 MCP 设置文件（位置因平台而异），将"YOUR_NETLIFY_PAT_HERE"替换为您的实际个人访问令牌：

将/path/to/Netlify-MCP-Server替换为您克隆/安装服务器的实际路径。

设置文件位置：

• Claude 桌面（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json
• Cline Dev 扩展（VS 代码）： /home/user/.codeoss-cloudworkstations/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json /.codeoss-cloudworkstations/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json（或基于 OS/设置的类似文件）
• 请参阅您的特定 MCP 客户端文档以了解其他潜在位置。

可用工具（兼容 Netlify CLI v19.1.5）

（参数基于src/index.ts中定义的 Zod 模式）

站点和部署管理

部署站点

将站点目录部署到 Netlify。

例子：

列表站点

列出链接到您帐户的所有 Netlify 网站。

例子：

触发构建

触发站点的新构建/部署。站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

构建站点

在本地运行 Netlify 构建（模拟 Netlify 构建环境）。如果提供了siteId ，则站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

链接站点

将当前项目目录链接到 Netlify 站点（非交互式使用需要站点 ID）。

例子：

取消链接网站

取消当前项目目录与关联的 Netlify 站点的链接。

例子：

获取状态

显示链接站点/目录的 Netlify 状态。（如果通过 MCP 服务器运行，可能会失败，除非服务器目录本身已链接）。

例子：

创建站点

在 Netlify 上创建一个新站点（非交互式）。

例子：

删除站点

从 Netlify 中删除一个站点。

例子：

环境变量管理

设置环境变量

为站点设置一个或多个环境变量。站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

获取环境变量

获取特定环境变量的值。如果提供了siteId ，则站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

取消设置环境变量

取消设置（删除）环境变量。如果提供了siteId ，则站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

导入环境

从.env文件导入环境变量。站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

克隆环境变量

将环境变量从一个站点克隆到另一个站点。需要链接或通过NETLIFY_SITE_ID指定源站点。

例子：

无服务器函数

获取日志

查看函数日志。站点上下文通过NETLIFY_SITE_ID环境变量传递。

例子：

可用资源（兼容 Netlify CLI v19.1.5）

使用这些资源 URI 直接访问 Netlify 数据：

• netlify://sites ：列出所有站点（ sites:list --json的 JSON 输出）
• netlify://sites/{siteId}/functions ：列出站点的功能（ functions:list --json的 JSON 输出，需要NETLIFY_SITE_ID={siteId}环境变量）
• netlify://sites/{siteId}/env ：列出站点的环境变量（ env:list --json的 JSON 输出，需要NETLIFY_SITE_ID={siteId}环境变量）

限制（Netlify CLI v19.1.5）

• **交互式命令：**此服务器不支持需要交互式提示的命令（例如netlify login 、 netlify init 、 netlify dev ）。请使用个人访问令牌进行身份验证。
• **站点上下文：**许多命令（ env:* 、 logs:function 、 build 、 trigger-build 、 functions:list ）都需要站点上下文。执行这些命令时，此服务器会通过NETLIFY_SITE_ID环境变量传递所需的siteId和unlink等status会作用于服务器的当前工作目录，而该目录通常未链接，因此通过 MCP 服务器调用时可能无法按预期运行。
• **不支持的命令：**由于与 CLI v19.1.5 不兼容，与 DNS、表单、插件、钩子和部署（列出特定部署、获取部署状态）相关的功能已被删除。

发展

修改服务器：

1. 更新src/index.ts中的源代码。
2. 使用npm run build进行构建。
3. 在客户端应用程序中重新启动 MCP 服务器以加载更改。
4. 测试您的更改。

资源

• Netlify CLI 文档
• MCP SDK 文档
• Zod 文档