MCP Server

npm @modularcore/mcp-server

Servidor MCP (Model Context Protocol) que expone la API HTTP del Registry de ModularCore a cualquier cliente MCP (Cursor, Claude Code, VS Code, ChatGPT, ...) por stdio. Es un adaptador ligero sobre @modularcore/registry-client — el mismo registry con el que habla el CLI (modularcore), sin backend adicional.

No se instala vía CLI ni como código copiado a tu proyecto: se registra en la configuración de tu cliente MCP y se ejecuta bajo demanda con npx.

Herramientas (tools)

Tool	Lee/escribe	Elicitation
`search_components(query, limit?)`	Registry HTTP (solo lectura)	ninguna
`get_component(name)`	Registry HTTP (solo lectura)	ninguna
`install_component(name, targetPath, version?)`	Registry HTTP + escritura en filesystem local	requerida
`check_updates(installedComponents)`	Registry HTTP (solo lectura)	ninguna

install_component es la única tool que escribe archivos: antes de escribir nada envía una petición elicitation/create al cliente MCP conectado mostrando la ruta destino resuelta, la versión del componente, qué envVariables son nuevas y qué dependencias npm declara el componente. El servidor nunca ejecuta npm install/pnpm add por su cuenta — esas dependencias son informativas.

Registrar el servidor

Configuración mcpServers para Cursor, Claude Code, VS Code y otros clientes compatibles con MCP:

{
  "mcpServers": {
    "modularcore": {
      "command": "npx",
      "args": ["-y", "@modularcore/mcp-server"],
      "env": {
        "MODULARCORE_REGISTRY_URL": "https://registry.example.com"
      }
    }
  }
}

Apunta MODULARCORE_REGISTRY_URL a tu propio registry hospedado (ver este mismo sitio, apps/web, como ejemplo de cómo se genera/sirve uno). Para desarrollo local contra un registry en localhost, añade "MODULARCORE_REGISTRY_ALLOW_INSECURE": "1" al bloque env.

targetPath en install_component se resuelve relativo al directorio donde el cliente MCP lanza el servidor (su cwd de proceso) — configura ese directorio de trabajo a la raíz de tu proyecto.

Seguridad de la URL del registry

No hay valor por defecto en producción: el servidor se niega a arrancar sin MODULARCORE_REGISTRY_URL configurada. Por defecto se exige https://; http:// se rechaza salvo que actives explícitamente --allow-insecure-registry o MODULARCORE_REGISTRY_ALLOW_INSECURE=1.

El texto de title/description/category que devuelven search_components y get_component proviene del servidor que apunte MODULARCORE_REGISTRY_URL — es contenido externo, no instrucciones. Cada respuesta de las tools de solo lectura incluye este mismo aviso como campo notice.

Instalación

npx -y @modularcore/mcp-server

Requiere Node.js 18 o superior.