Netlify MCP Server

🚀 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