🚀 Netlify CLI v19.1.5 与 MCP 服务器集成指南
本指南详细介绍了如何将 Netlify CLI v19.1.5 与 MCP 服务器集成，包含命令参考、资源访问 URI、限制说明以及开发步骤等内容，帮助你顺利完成集成操作。
🚀 快速开始
若你想将 Netlify CLI v19.1.5 与 MCP 服务器集成，可按以下步骤操作：
- 克隆项目仓库：
git clone https://github.com/yourusername/mcp-netlify.git
cd mcp-netlify
- 安装 npm 包：
npm install
- 启动开发服务器：
npm run dev
✨ 主要特性
- 提供丰富的站点管理命令，如创建、列出和删除站点。
- 支持环境变量的管理，包括列出、添加、更新和删除操作。
- 可查看指定站点中特定函数的日志。
- 提供资源访问 URI，方便获取站点、函数和环境变量信息。
📦 安装指南
安装依赖
- 克隆项目仓库:
git clone https://github.com/yourusername/mcp-netlify.git
cd mcp-netlify
- 安装 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