JinDaGe - netlify-mcp MCP Details

article

README

🚀 Netlify MCP 服务器

Netlify MCP 服务器遵循模型上下文协议 (MCP)，使代码智能体能够使用 Netlify API 和 CLI，从而可以通过自然语言提示来创建新项目、构建、部署和管理你的 Netlify 资源。

🚀 快速开始

Netlify MCP 服务器可让代码智能体借助自然语言提示，利用 Netlify API 和 CLI 管理资源。在使用前，你需要完成以下准备工作：

确保安装 Node.js 22 或更高版本，可以使用 node --version 进行检查。
拥有一个 Netlify 账户。
准备一个 MCP 客户端，如 Windsurf、Cursor、Claude、Copilot 等。

提示：为获得最佳体验，可全局安装 Netlify CLI：npm install -g netlify-cli

✨ 主要特性

标准协议支持

模型上下文协议是一种新兴的标准协议，用于将代码智能体与 MCP 服务器连接起来，允许它们使用自然语言管理资源和执行任务。Netlify MCP 服务器充当桥梁，为你的智能体提供 API 访问、CLI 工具、提示等功能。

多客户端兼容

你可以使用各种 MCP 客户端连接到 Netlify MCP 服务器，包括：

Windsurf
Cursor
Claude
Copilot (VSCode)
Cline
Warp
LM Studio
查看完整列表

📦 安装指南

生产环境 MCP 服务器配置

对于生产环境的 MCP 服务器，你可以使用以下方式进行配置：

支持一键安装的编辑器：

在 Cursor 中安装 MCP 服务器
将 Netlify MCP 服务器添加到 LM Studio
在 VS Code 中安装
在 VS Code 内部版本中安装
在 Goose 中安装
- 如果链接无法渲染或打开，可以在浏览器中使用以下链接：goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify's%20official%20MCP%20server.

MCP 配置文件的配置如下：

{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ]
    }
  }
}

本地开发配置

如需进行本地开发，请参考设置本地 MCP 配置。

💻 使用示例

借助 Netlify MCP 服务器，你的 AI 智能体可以实现以下功能：

创建、管理和部署 Netlify 项目
修改访问控制，增强项目安全性
安装或卸载 Netlify 扩展
获取用户和团队信息
启用和管理表单提交
创建和管理环境变量与机密信息
以及更多...

📚 详细文档

常见问题排查

Node 版本问题

为获得最佳效果，请使用 Node.js 22 或更高版本。
如果你使用 nvm，可以运行以下命令：

nvm install 22
nvm use 22

Netlify 认证问题排查

如果你遇到认证问题，可以临时将 Netlify 个人访问令牌 (PAT) 添加到你的 MCP 配置中：

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

请勿将你的 PAT 提交到代码仓库！ 问题解决后，请从配置中移除你的 PAT。

生成新的个人访问令牌 (PAT)

在 Netlify 仪表板中，选择你的用户图标。
转到 用户设置 > OAuth > 新访问令牌。
复制你的令牌，并按上述方式临时添加到你的 MCP 配置中。
重启或刷新你的 MCP 客户端。

netlify-mcp