local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Vercel MCP 服务器🚀
🔥 强大的模型上下文协议 (MCP) 服务器,可通过 Cursor 的 Composer 和 Codeium 的 Cascade 为您的 Vercel 部署提供全面的管理控制。此工具提供全面的部署、域、环境变量等功能,可实现无缝的项目管理。
📚 目录
🔧 先决条件
- Node.js >= 16.x
- npm >= 8.x
- 拥有以下权限的 Vercel 帐户:
- 访问令牌
- 团队 ID(可选)
- 项目 ID(可选)
- Cursor IDE 或 Codeium 的 Cascade(针对付费用户)
🚀 快速入门
📥 安装
Copy
⚙️ 配置
- 安装依赖项并构建项目:Copy
- 设置您的 Vercel 访问令牌:
- 前往https://vercel.com/account/tokens生成您的访问令牌
- 更新这两个文件中的令牌:在
src/config/constants.ts
中:在Copysrc/index.ts
中:Copy
- 在 Cursor 的 MCP 设置中,使用以下命令添加服务器:对于 macOS:对于 Windows:Copy对于 Linux:Copy将Copy
/path/to/vercel-mcp
或C:\path\to\vercel-mcp
替换为您的实际安装路径。要查找您的 Node.js 路径:Copy
注意:请确保您的 Vercel 访问令牌安全,切勿将其提交到版本控制中。
🎯 功能
🎯 可用工具
团队管理
- 团队:
create_team
、delete_team
、get_team
、list_teams
、update_team
- 团队成员:
list_team_members
、invite_team_member
、remove_team_member
、update_team_member
项目管理
- 项目:
list_projects
、create_project
、delete_project
、update_project
、pause_project
- 项目成员:
add_project_member
、list_project_members
、remove_project_member
- 项目转移:
request_project_transfer
,accept_project_transfer
部署管理
- 部署:
create_deployment
、cancel_deployment
、get_deployment
、delete_deployment
、list_deployment
- 部署事件:
get_deployment_events
、update_deployment_integration
- 部署文件:
list_deployment_files
、upload_deployment_files
、get_deployment_file
- 促销:
promote_deployment
、get_promotion_aliases
域名和 DNS 管理
- 域名:
add_domain
、remove_domain
、get_domain
、list_domains
、get_project_domain
- 域操作:
domain_check
、domain_price
、domain_config
、domain_registry
、domain_get
、domain_list
、domain_buy
、domain_register
、domain_remove
、domain_update
- DNS:
create_dns_record
、delete_dns_record
、list_dns_records
、update_dns_record
- 证书:
get_cert
、issue_cert
、remove_cert
、upload_cert
环境与配置
- 环境变量:
add_env
、update_env
、delete_env
、get_env
、list_env
- 边缘配置:
create_edge_config
、update_edge_config
、delete_edge_config
、get_edge_config
、list_edge_configs
- 边缘配置项:
list_edge_config_items
、get_edge_config_item
、update_edge_config_items
- 边缘配置模式:
get_edge_config_schema
、update_edge_config_schema
、delete_edge_config_schema
- 边缘配置令牌:
create_edge_config_token
、get_edge_config_token
、list_edge_config_tokens
、delete_edge_config_tokens
- Edge 配置备份:
list_edge_config_backups
、get_edge_config_backup
访问控制和安全
- 访问组:
create_access_group
、delete_access_group
、update_access_group
、get_access_group
、list_access_groups
- 访问组项目:
create_access_group_project
、delete_access_group_project
、get_access_group_project
、list_access_group_projects
- 访问组成员:
list_access_group_members
- 身份验证:
create_auth_token
、delete_auth_token
、get_auth_token
、list_auth_tokens
、sso_token_exchange
- 防火墙:
create_firewall_bypass
、delete_firewall_bypass
、get_firewall_bypass
、get_attack_status
、update_attack_mode
、get_firewall_config
、update_firewall_config
、put_firewall_config
监控和日志记录
- 日志流失:
logdrain_create
、logdrain_createIntegration
、logdrain_delete
、logdrain_deleteIntegration
、logdrain_get
、logdrain_list
、logdrain_listIntegration
- Webhook:
create_webhook
、delete_webhook
、list_webhooks
、get_webhook
- 分析:
send_web_vitals
用户管理
- 用户:
delete_user
、get_user
、list_user_events
市场与整合
- 市场:
create_marketplace_event
、get_marketplace_account
、get_marketplace_invoice
、get_marketplace_member
、import_marketplace_resource
、submit_marketplace_billing
、submit_marketplace_invoice
、update_marketplace_secrets
、marketplace_sso_token_exchange
、submit_marketplace_balance
、marketplace_invoice_action
- 集成:
int_delete
、int_list
、int_gitns
、int_searchRepo
、int_get
、int_updateAction
环境与秘密
- 环境:
create_environment
、delete_environment
、get_environment
、list_environments
、update_environment
- 秘密:
create_secret
、update_secret_name
、delete_secret
、get_secret
、list_secrets
文物与别名
- 工件:
check_artifact
、download_artifact
、get_artifact_status
、query_artifacts
、record_artifact_events
、upload_artifact
- 别名:
assign_alias
、delete_alias
、get_alias
、list_aliases
、list_deployment_aliases
💡 使用方法
配置完成后,MCP 服务器将通过 Cursor 的 Composer 提供所有 Vercel 管理工具。只需描述您想对 Vercel 项目执行的操作,AI 就会使用相应的命令。
例子:
- 📋“列出我的所有项目”
- 🚀“创建一个新的 Next.js 项目”
- 🌐“向我的项目添加自定义域”
- 🔑“设置环境变量”
🔒 安全说明
- 🔐 确保您的 Vercel 访问令牌安全
- ⚠️ 切勿将敏感凭据提交到版本控制
- 👮 使用适当的访问控制和权限
- 🛡️ 遵循 Vercel 的安全最佳实践
🛠️ 故障排除
常见问题
- Node.js 路径问题
- 确保使用正确的 Node.js 路径
- 在 Mac/Linux 上:使用
which node
来查找正确的路径 - 在 Windows 上:使用
where node
查找正确的路径
- 访问令牌问题
- 验证您的 Vercel 访问令牌是否有效
- 检查令牌是否具有所需的权限
- 确保令牌未过期
- MCP 未检测工具
- 点击 Cursor 的 MCP 设置中的刷新按钮
- 确保服务器正在运行(没有错误消息)
- 验证您的 Vercel 凭证是否有效
调试模式
在命令前添加DEBUG=true
即可查看详细日志:
Copy
如果您仍然遇到问题,请打开以下问题:
- 您的操作系统
- Node.js 版本(
node --version
) - 完整错误消息
- 复现步骤
🤝 贡献
欢迎贡献代码!欢迎提交 Pull 请求。
📄 许可证
You must be authenticated.
强大的模型上下文协议 (MCP) 服务器,可通过 Cursor 的 Composer 或 Codeium 的 Cascade 实现无缝的 Vercel 项目管理,包括部署、域、环境变量和团队配置。
- 📚 Table of Contents
- 🔧 Prerequisites
- 🚀 Quick Start
- 🎯 Features
- 💡 Usage
- 🔒 Security Notes
- 🛠️ Troubleshooting
- 🤝 Contributing
- 📄 License