🚀 Netlify CLI v19.1.5 与 MCP 服务器集成指南

本指南详细介绍了如何将 Netlify CLI v19.1.5 与 MCP 服务器集成，包含命令参考、资源访问 URI、限制说明以及开发步骤等内容，帮助你顺利完成集成操作。

🚀 快速开始

若你想将 Netlify CLI v19.1.5 与 MCP 服务器集成，可按以下步骤操作：

1. 克隆项目仓库：

git clone https://github.com/yourusername/mcp-netlify.git
cd mcp-netlify

2. 安装 npm 包：

npm install

3. 启动开发服务器：

npm run dev

✨ 主要特性

• 提供丰富的站点管理命令，如创建、列出和删除站点。
• 支持环境变量的管理，包括列出、添加、更新和删除操作。
• 可查看指定站点中特定函数的日志。
• 提供资源访问 URI，方便获取站点、函数和环境变量信息。

📦 安装指南

安装依赖

1. 克隆项目仓库:

git clone https://github.com/yourusername/mcp-netlify.git
cd mcp-netlify

2. 安装 npm 包:

npm install

💻 使用示例

站点管理

创建站点

• 命令: netlify sites:create
• 功能: 使用个人访问令牌创建新站点。
• 示例:

netlify sites:create --token=your PAT here

列出站点

• 命令: netlify sites:list
• 功能: 显示所有用户拥有的站点列表。

删除站点

• 命令: netlify sites:delete
• 功能: 使用个人访问令牌删除指定站点。
• 示例:

netlify sites:delete --site-id=your site ID here

环境变量管理

列出环境变量

• 命令: netlify env:list
• 功能: 显示指定站点的所有环境变量。
• 示例:

netlify env:list --site-id=your site ID here

添加环境变量

• 命令: netlify env:create
• 功能: 在指定站点中创建新的环境变量。
• 示例:

netlify env:create --site-id=your site ID here --key=NEW_VAR --value="hello world"

更新环境变量

• 命令: netlify env:update
• 功能: 更新指定站点中的现有环境变量。
• 示例:

netlify env:update --site-id=your site ID here --key=EXISTING_VAR --value="new value"

删除环境变量

• 命令: netlify env:delete
• 功能: 在指定站点中删除特定环境变量。
• 示例:

netlify env:delete --site-id=your site ID here --key=OLD_VAR

函数日志

查看函数日志

• 命令: netlify logs:functions
• 功能: 显示指定站点中特定函数的日志。
• 示例:

netlify logs:functions --site-id=your site ID here --function=my-function-name

测试命令

列出所有站点

npm run command sites:list

创建新站点

npm run command sites:create -- --token=your PAT here

删除指定站点

npm run command sites:delete -- --site-id=your site ID here

验证环境变量操作

列出所有环境变量

npm run command env:list -- --site-id=your site ID here

创建新环境变量

npm run command env:create -- --site-id=your site ID here --key=NEW_VAR --value="hello world"

更新现有环境变量

npm run command env:update -- --site-id=your site ID here --key=EXISTING_VAR --value="new value"

删除特定环境变量

npm run command env:delete -- --site-id=your site ID here --key=OLD_VAR

📚 详细文档

资源访问 URI

• netlify://sites: 列出所有站点（等同于 sites:list --json 的 JSON 输出）
• netlify://sites/{siteId}/functions: 列出指定站点中的函数（等同于 functions:list --json，需要设置 NETLIFY_SITE_ID={siteId} 环境变量）
• netlify://sites/{siteId}/env: 列出指定站点的环境变量（等同于 env:list --json，需要设置 NETLIFY_SITE_ID={siteId} 环境变量）

限制

• 交互式命令: 需要用户输入提示的命令（如 netlify login、netlify init、netlify dev）不支持通过此服务器运行。请使用个人访问令牌进行身份验证。
• 站点上下文: 多个命令（如 env:*、logs:function、build、trigger-build、functions:list）需要站点上下文。此服务器通过设置 NETLIFY_SITE_ID 环境变量来传递所需的 siteId。命令如 status 和 delete 仍需手动指定 --site-id 参数。
• 功能限制: 此集成目前不支持以下功能：
  • 使用配置文件
  • 部署站点
  • 管理钩子
  • 管理域名

开发步骤

启动开发服务器

npm run dev

构建生产版本

npm run build