MCP Server

npm@modularcore/mcp-server@0.3.1

El servidor MCP conecta Cursor, Claude Code, VS Code y otros clientes al registry de ModularCore. Es un proceso local por stdio: el cliente lo inicia con npx cuando lo necesita. No es el CLI y no se ejecuta manualmente para instalar componentes.

Antes de configurarlo

Usa Node.js 18 o superior.
Abre tu proyecto en el cliente MCP; el servidor escribirá únicamente bajo esa raíz.
Comprueba que https://tu-dominio.example/registry/index.json devuelve JSON.

Cursor

Crea .cursor/mcp.json dentro del proyecto:

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

El servidor resuelve las escrituras desde el directorio de trabajo que Cursor le entrega. No uses una configuración global para instalar componentes: puede no apuntar al repositorio abierto.

Claude Code

Desde la raíz del proyecto, registra una configuración local:

claude mcp add --transport stdio modularcore \
  --env MODULARCORE_REGISTRY_URL=https://tu-dominio.example/registry \
  -- npx -y @modularcore/mcp-server@0.3.1

Usa --scope project si quieres compartir la configuración en .mcp.json. Revisa su contenido antes de versionarlo.

VS Code

Crea .vscode/mcp.json para la configuración del workspace:

{
  "servers": {
    "modularcore": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modularcore/mcp-server@0.3.1"],
      "cwd": "${workspaceFolder}",
      "env": {
        "MODULARCORE_REGISTRY_URL": "https://tu-dominio.example/registry"
      }
    }
  }
}

.mcp.json en la raíz se reserva para configuraciones portables de Agent Host; no es el archivo de configuración de workspace de VS Code.

Clientes compatibles

Configura un servidor stdio con npx, los argumentos del ejemplo y la variable de entorno del registry. El directorio de trabajo debe ser la raíz de tu proyecto.

Qué puede hacer

Tool	Acción
`search_components`	Busca en el registry (solo lectura).
`get_component`	Consulta archivos, versión y dependencias (solo lectura).
`check_updates`	Comprueba componentes instalados (solo lectura).
`install_component`	Solicita confirmación y solo después escribe archivos bajo el proyecto.

install_component requiere que el cliente soporte elicitation. Si no lo soporta, la instalación falla sin escribir nada; buscar y consultar siguen funcionando. El servidor nunca ejecuta npm install ni pnpm add por su cuenta.

Seguridad

En producción la URL debe usar HTTPS. Para desarrollo local, añade MODULARCORE_REGISTRY_ALLOW_INSECURE=1 solo si controlas la red y usas un registry HTTP local.