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

Related MCP server: Vercel MCP

🔧 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

# Clone the repository
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 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:

# macOS/Linux
DEBUG=true /usr/local/bin/node /path/to/vercel-mcp/dist/index.js

# Windows
set DEBUG=true && "C:\Program Files\nodejs\node.exe" "C:\path\to\vercel-mcp\dist\index.js"

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