Vercel MCP Server

🚀 Vercel管理控制檯（MCP）配置指南

本指南將詳細介紹如何配置和使用Vercel管理控制檯（MCP），幫助你輕鬆管理Vercel項目。

🚀 快速開始

按照以下步驟完成Vercel管理控制檯（MCP）的配置，即可使用相關管理工具。

📦 安裝指南

要使用Vercel管理工具，請按照以下步驟進行：

1. 獲取訪問令牌
   • 登錄Vercel官網。
   • 進入“用戶設置”>“安全”>“訪問令牌”。
   • 創建並複製一個新的訪問令牌。
2. 配置MCP服務器
   • 將複製的訪問令牌粘貼到config.json文件中。
   • 確保文件路徑為：vercel-mcp/config.json。

   {
     "token": "your-vercel-token"
   }
   

3. 啟動服務
   • 打開終端，導航到vercel-mcp目錄。
   • 運行命令：

   node index.js
   

   • 服務器將在http://localhost:4001啟動。

💻 使用示例

基礎用法

完成配置後，MCP服務器將提供所有Vercel管理工具。通過Cursor的Composer描述您需要執行的操作，AI將自動調用相應的命令。

高級用法

以下是一些常見操作的示例場景：

• 查詢項目列表：輸入“列出我的所有項目”。
• 創建新項目：輸入“創建一個新的Next.js項目”。
• 綁定：輸入“為項目添加自定義域名”。
• 環境變量管理：輸入“設置環境變量”。

⚠️ 安全提示

• 令牌安全：確保訪問令牌僅用於可信網絡環境。
• 權限控制：限制令牌的使用範圍和有效期。
• 日誌監控：定期檢查操作日誌，發現異常及時處理。

🛠️ 故障排查

常見問題

1. Node.js路徑錯誤
   • 確認系統中已安裝Node.js。
   • 使用命令node --version檢查版本。
   • 使用命令which node（mac/Linux）或where node（Windows）確認路徑。
2. 令牌失效
   • 檢查令牌是否過期。
   • 確保令牌具備所需權限。
   • 如需重新生成，請訪問Vercel官網。
3. 工具未識別
   • 在Cursor的MCP設置中點擊“刷新”按鈕。
   • 確認服務器運行狀態（無錯誤提示）。
   • 驗證Vercel憑證是否正確。

調試模式

在命令前添加DEBUG=true以顯示詳細日誌：

# mac/Linux
DEBUG=true node index.js

# Windows
set DEBUG=true & node index.js

如仍無法解決問題，請提供以下信息：

• 操作系統版本。
• Node.js版本。
• 具體錯誤信息。
• 問題復現步驟。

🤝 貢獻指南

歡迎貢獻！請隨意提交修復或改進的Pull Request。