Paquete MCP Local
@dypai-ai/mcp (v1.6.17) es el paquete local del Model Context Protocol. Corre en tu máquina, lee los archivos de tu proyecto y deja que tu agente de IA despliegue tu app a producción — algo que el servidor alojado no puede hacer, porque nunca ve tu sistema de archivos.
Normalmente no eliges uno u otro: la mayoría se conecta al MCP remoto para editar y añade el paquete local para los deploys.
Remoto vs local
| MCP remoto (cloud) | Local — @dypai-ai/mcp | |
|---|---|---|
| Dónde corre | Un servidor HTTP alojado | En tu máquina, vía npx |
| Herramientas | 41 herramientas para el agente | 28 herramientas (perfil por defecto) |
| Acceso a archivos | Ninguno | Lee los archivos de tu proyecto |
| Ideal para | Edición dentro del IDE — tablas, endpoints, auth, logs | Desplegar, comparar y sincronizar tu código |
| Configuración | Pega el JSON de config | npx @dypai-ai/install |
El servidor remoto es al que se conecta el JSON de config MCP (ver Integración MCP). El paquete local añade el despliegue desde tu sistema de archivos — empaqueta tu código y lo publica.
¿Por qué dos superficies?
El servidor cloud puede editar tu backend desde cualquier sitio, pero no puede leer los archivos de tu ordenador. El paquete local cubre ese hueco: sube tu proyecto local a HeroMate y lo despliega a producción.
Instalación
El paquete local se instala igual que el resto de MCP — a través de @dypai-ai/install:
npx @dypai-ai/install
El instalador te deja elegir tu cliente (Claude Code, Codex, Cursor, Windsurf, Antigravity, y otros) e inicia sesión para obtener un token. Una vez configurado, tu agente de IA puede llamar a las herramientas locales directamente. Ejecuta npx @dypai-ai/install --help para ver todas las opciones.
Las 28 herramientas por defecto
El perfil local combina herramientas de despliegue que usan tu sistema de archivos (exclusivas del paquete local) con un subconjunto de las herramientas remotas compartidas, para que tu agente pueda editar y publicar sin cambiar de contexto.
Despliegue y sincronización
Estas son las herramientas que necesitan tu sistema de archivos — la razón de ser del paquete local:
| Parameter | Type | Description |
|---|---|---|
dypai_push | Tool | Sube los cambios locales a tu proyecto de HeroMate |
dypai_pull | Tool | Trae el estado más reciente del proyecto a tus archivos locales |
dypai_diff | Tool | Muestra qué difiere entre tus archivos locales y el proyecto desplegado |
dypai_validate | Tool | Valida tus workflows y config locales antes de desplegar |
dypai_deploy_production | Tool | Despliega tu app a producción |
dypai_generate_types | Tool | Genera tipos TypeScript para tus endpoints (endpoints.gen.ts) |
dypai_test_endpoint | Tool | Ejecuta un endpoint en local para comprobar que funciona |
bulk_upsert | Tool | Inserta o actualiza muchas filas de la base de datos a la vez |
Base de datos y storage
| Parameter | Type | Description |
|---|---|---|
execute_sql | Tool | Ejecuta consultas SQL contra la base de datos de tu proyecto |
manage_database | Tool | Inspecciona y gestiona tablas, columnas y migraciones |
manage_storage | Tool | Sube, lista, mueve o elimina archivos de un bucket |
generate_image_asset | Tool | Genera una imagen gestionada (facturada como AI Credits) y la guarda en storage |
Auth, agendas y webhooks
| Parameter | Type | Description |
|---|---|---|
manage_users | Tool | Crea, lista, actualiza o elimina usuarios |
manage_roles | Tool | Crea, actualiza o elimina roles personalizados |
manage_schedules | Tool | Crea, pausa, reanuda o elimina ejecuciones programadas |
manage_webhooks | Tool | Crea y gestiona triggers de webhook entrantes |
Proyectos y versiones
| Parameter | Type | Description |
|---|---|---|
list_projects | Tool | Lista los proyectos a los que tienes acceso |
get_project | Tool | Obtén los detalles de un proyecto |
create_project | Tool | Crea un proyecto nuevo |
get_app_credentials | Tool | Lista las credenciales configuradas del proyecto |
get_endpoint_versions | Tool | Consulta el historial de versiones de un endpoint |
manage_domain | Tool | Conecta o inspecciona un dominio personalizado |
Docs, búsqueda y artefactos
| Parameter | Type | Description |
|---|---|---|
list_ai_models | Tool | Lista los modelos de IA disponibles en tu plan |
search_docs | Tool | Busca en la documentación de HeroMate |
search_logs | Tool | Busca en los logs de ejecución y de la aplicación |
search_flow_templates | Tool | Encuentra plantillas de workflow para patrones comunes |
search_project_artifacts | Tool | Busca artefactos del proyecto (archivos, blueprints, briefs) |
manage_project_artifact | Tool | Crea o actualiza un artefacto del proyecto |
Cuándo usar cada uno
Usa el MCP remoto para…
Editar tu backend dentro del IDE — tablas, endpoints, auth, logs, traces. 41 herramientas.
Usa el paquete local para…
Publicar código — push/pull, diff contra producción, deploy y generar tipos desde tus archivos. 28 herramientas.
En la práctica, tu agente usa las herramientas remotas para construir y las locales para desplegar. Mantén ambas configuradas y deja que elija la adecuada para cada tarea.