Servidor Vercel MCP 🚀

Un potente servidor de Protocolo de Contexto de Modelo (MCP) que proporciona control administrativo completo sobre sus implementaciones de Vercel mediante Cursor Composer y Cascade de Codeium. Esta herramienta permite una gestión de proyectos fluida con funciones completas para implementaciones, dominios, variables de entorno y más.

📚 Índice de contenidos

• Prerrequisitos
• Inicio rápido
• Integraciones
• Características
• Uso
• Notas de seguridad
• Solución de problemas
• Contribuyendo
• Licencia

🔧 Requisitos previos

• Node.js >= 16.x
• npm >= 8.x
• Una cuenta Vercel con:
  • Token de acceso
  • ID del equipo (opcional)
  • ID del proyecto (opcional)
• Cursor IDE o Cascade de Codeium (para usuarios de pago)

🚀 Inicio rápido

📥 Instalación

⚙️ Configuración

1. Instalar dependencias y compilar el proyecto:
   npm install npm run build
2. Configura tu token de acceso de Vercel:
   • Vaya a https://vercel.com/account/tokens para generar su token de acceso
   • Actualice el token en ambos archivos:En src/config/constants.ts :
     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
     En src/index.ts :
     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
3. En la configuración de MCP de Cursor, agregue el servidor con este comando:Para macOS:
   # Default installation /usr/local/bin/node /path/to/vercel-mcp/dist/index.js # Homebrew installation /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   Para Windows:
   # Default installation C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # NVM for Windows C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # Scoop installation C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
   Para Linux:
   # Default installation /usr/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   Reemplace /path/to/vercel-mcp o C:\path\to\vercel-mcp con su ruta de instalación real.Para encontrar su ruta Node.js:
   # macOS/Linux which node # Windows where node

Nota: Mantenga seguro su token de acceso de Vercel y nunca lo comprometa con el control de versiones.

🎯 Características

🎯 Herramientas disponibles

Gestión de equipos

• Equipos: create_team , delete_team , get_team , list_teams , update_team
• Miembros del equipo: list_team_members , invite_team_member , remove_team_member , update_team_member

Gestión de proyectos

• Proyectos: list_projects , create_project , delete_project , update_project , pause_project
• Miembros del proyecto: add_project_member , list_project_members , remove_project_member
• Transferencia de proyecto: request_project_transfer , accept_project_transfer

Gestión de la implementación

• Implementaciones: create_deployment , cancel_deployment , get_deployment , delete_deployment , list_deployment
• Eventos de implementación: get_deployment_events , update_deployment_integration
• Archivos de implementación: list_deployment_files , upload_deployment_files , get_deployment_file
• Promoción: promote_deployment , get_promotion_aliases

Gestión de dominios y DNS

• Dominios: add_domain , remove_domain , get_domain , list_domains , get_project_domain
• Operaciones de dominio: 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
• Certificados: get_cert , issue_cert , remove_cert , upload_cert

Entorno y configuración

• Variables de entorno: add_env , update_env , delete_env , get_env , list_env
• Configuración de borde: create_edge_config , update_edge_config , delete_edge_config , get_edge_config , list_edge_configs
• Elementos de configuración de Edge: list_edge_config_items , get_edge_config_item , update_edge_config_items
• Esquema de configuración de borde: get_edge_config_schema , update_edge_config_schema , delete_edge_config_schema
• Tokens de configuración de borde: create_edge_config_token , get_edge_config_token , list_edge_config_tokens , delete_edge_config_tokens
• Copias de seguridad de configuración de Edge: list_edge_config_backups , get_edge_config_backup

Control de acceso y seguridad

• Grupos de acceso: create_access_group , delete_access_group , update_access_group , get_access_group , list_access_groups
• Proyectos de grupo de acceso: create_access_group_project , delete_access_group_project , get_access_group_project , list_access_group_projects
• Miembros del grupo de acceso: list_access_group_members
• Autenticación: create_auth_token , delete_auth_token , get_auth_token , list_auth_tokens , sso_token_exchange
• Cortafuegos: create_firewall_bypass , delete_firewall_bypass , get_firewall_bypass , get_attack_status , update_attack_mode , get_firewall_config , update_firewall_config , put_firewall_config

Monitoreo y registro

• Drenajes de registro: logdrain_create , logdrain_createIntegration , logdrain_delete , logdrain_deleteIntegration , logdrain_get , logdrain_list , logdrain_listIntegration
• Webhooks: create_webhook , delete_webhook , list_webhooks , get_webhook
• Análisis: send_web_vitals

Gestión de usuarios

• Usuarios: delete_user , get_user , list_user_events

Mercado e integración

• Mercado: 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
• Integraciones: int_delete , int_list , int_gitns , int_searchRepo , int_get , int_updateAction

Entornos y secretos

• Entornos: create_environment , delete_environment , get_environment , list_environments , update_environment
• Secretos: create_secret , update_secret_name , delete_secret , get_secret , list_secrets

Artefactos y alias

• Artefactos: check_artifact , download_artifact , get_artifact_status , query_artifacts , record_artifact_events artefacto, upload_artifact
• Alias: assign_alias , delete_alias , get_alias , list_aliases , list_deployment_aliases

💡 Uso

Una vez configurado, el servidor MCP proporciona todas las herramientas de gestión de Vercel a través de Cursor Composer. Simplemente describa qué desea hacer con sus proyectos de Vercel y la IA usará los comandos adecuados.

Ejemplos:

• 📋 "Enumerar todos mis proyectos"
• 🚀 "Crear un nuevo proyecto Next.js"
• 🌐 "Añadir un dominio personalizado a mi proyecto"
• 🔑 "Configurar variables de entorno"

🔒 Notas de seguridad

• 🔐 Mantenga seguro su token de acceso de Vercel
• ⚠️ Nunca envíe credenciales confidenciales al control de versiones
• 👮 Utilice controles de acceso y permisos adecuados
• 🛡️ Siga las mejores prácticas de seguridad de Vercel

🛠️ Solución de problemas

Problemas comunes

1. Problemas de ruta en Node.js
   • Asegúrese de estar utilizando la ruta Node.js correcta
   • En Mac/Linux: utilice which node para encontrar la ruta correcta
   • En Windows: utilice where node para encontrar la ruta correcta
2. Problemas con el token de acceso
   • Verifique que su token de acceso de Vercel sea válido
   • Comprueba si el token tiene los permisos necesarios
   • Asegúrese de que el token no haya expirado
3. MCP no detecta herramientas
   • Haga clic en el botón Actualizar en la configuración de MCP del Cursor
   • Asegúrese de que el servidor esté funcionando (sin mensajes de error)
   • Verifique que sus credenciales de Vercel sean válidas

Modo de depuración

Agregue DEBUG=true antes de su comando para ver registros detallados:

Si aún tiene problemas, abra un problema con:

• Su sistema operativo
• Versión de Node.js ( node --version )
• Mensaje de error completo
• Pasos para reproducir

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia