Quegenx Vercel MCP Server

🚀 Vercel 管理命令接口（MCP）安裝指南

本項目為 Cursor 提供了 Vercel 管理工具，通過配置 MCP 服務器，可方便地對 Vercel 項目進行管理操作。

🚀 快速開始

按照以下步驟完成 Vercel 管理命令接口（MCP）的安裝與配置：

📦 安裝指南

1. 下載並安裝 Node.js

確保你已安裝 Node.js，推薦使用 LTS 版本。

2. 克隆 MCP 倉庫

打開終端，運行以下命令：

git clone https://github.com/Quegenx/cursor-vercel-mcp.git

3. 安裝依賴項

進入倉庫目錄，運行：

npm install

4. 啟動 MCP 服務

安裝完成後，運行以下命令啟動服務：

npm start

5. 配置 Vercel 訪問令牌

在 Cursor 的 MCP 設置中，添加你的 Vercel 訪問令牌以完成身份驗證。

📚 詳細文檔

配置指南

初始化 MCP 服務器

在終端運行以下命令啟動 MCP 服務：

npm start

訪問令牌配置

將 VERCEL_ACCESS_TOKEN 環境變量添加到你的項目中，確保其安全。

💻 使用示例

基礎用法

一旦配置完成，MCP 服務器將為 Cursor 提供所有 Vercel 管理工具。只需描述你想對 Vercel 項目執行的操作，AI 即會使用相應的命令進行處理。以下是一些示例用法：

列出所有項目

vercel projects list

創建新項目

vercel projects create --name my-next-project --type nextjs

添加自定義域名

vercel domains add mydomain.com -p projectId

設置環境變量

vercel envs create PROJECT_ID VARIABLE_NAME=variable_value

⚠️ 安全注意事項

1. 保持令牌安全

確保 Vercel 訪問令牌的安全性，避免洩露。

2. 權限控制

使用適當的訪問控制策略，限制令牌的使用範圍和權限。

3. 遵循最佳實踐

遵循 Vercel 的安全建議，定期審查和更新你的配置。

🛠️ 故障排除

常見問題

1. Node.js 路徑問題

確保使用正確的 Node.js 路徑：

• Mac/Linux：使用 which node 查找路徑。
• Windows：使用 where node 查找路徑。

2. 令牌無效

驗證 Vercel 訪問令牌的有效性，確保其未過期且具有必要的權限。

3. MCP 無法識別工具

• 在 Cursor 的 MCP 設置中點擊刷新按鈕。
• 確保服務器正常運行（無錯誤信息）。
• 檢查 Vercel 憑據是否有效。

調試模式

在命令前添加 DEBUG=true 以啟用詳細日誌輸出：

# Mac/Linux
DEBUG=true npm start

# Windows
set DEBUG=true && npm start

🤝 貢獻指南

歡迎貢獻！請隨意提交 Pull Request。