aurum-mcp

Habla con el Sistema de Diseño Aurum desde tu cliente LLM. Componentes · tokens · iconos · IDs de nodos de Figma · registro de cambios — todo consultable desde Claude Code, Cursor, Copilot CLI, Gemini y Claude Desktop.

aurum-mcp es un servidor del Protocolo de Contexto de Modelo (MCP) que expone el catálogo del sistema de diseño Aurum a los LLM. Lee un manifiesto JSON empaquetado (sincronizado automáticamente desde changejarapp.github.io/aurum-android) y expone 9 herramientas que el LLM puede llamar para responder preguntas como:

• "Muéstrame cómo usar AurumChip."

• "¿Qué token de color tenemos para texto de retroalimentación negativa?"

• "¿Cuál es el nodo de Figma para AurumTopAppBar?"

• "Dame el icono para una flecha de retroceso."

• "¿Qué cambió en la versión más reciente?"

Instalación (un solo pegado, para cada cliente)

Elige tu cliente a continuación, pega el fragmento en el archivo de configuración correspondiente, reinicia el cliente.

Claude Code (.mcp.json en la raíz de tu proyecto, o ~/.claude.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Copilot CLI (~/.copilot/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Gemini CLI (~/.gemini/settings.json bajo mcpServers)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

La misma estructura: suelta el fragmento anterior en mcpServers. Reinicia la aplicación.

Eso es todo. Sin registro npm, sin ~/.npmrc, sin PAT, sin variables de entorno. Git público, npx público.

Versionado

El fragmento predeterminado usa #latest-stable — una etiqueta Git gestionada por CI que siempre apunta a la versión estable más reciente. Se comporta como la etiqueta de distribución @latest de npm: obtienes actualizaciones automáticas en cada fallo de caché de npx (~10 min a unas pocas horas, dependiendo de la caché de tu cliente).

Para reproducibilidad — scripts automatizados, configuraciones auditadas — fija una etiqueta explícita:

"args": ["-y", "github:atri-jar/aurum-mcp#v0.1.0"]

Cada versión de aurum-mcp incluye el manifiesto de la versión de la biblioteca Aurum correspondiente (@aurum-mcp:0.1.6 ⇄ aurum:0.1.6). Llama a get_aurum_version desde tu cliente LLM para ver exactamente con qué estás interactuando.

Herramientas

Consulta docs/tools.md para ver los esquemas de entrada completos y ejemplos de respuestas.

¿Por qué npx-desde-Git y no npm?

Consideramos tres canales de distribución (npm público, GitHub Packages, npx-desde-Git) y elegimos el tercero porque para una herramienta interna del equipo que optimiza la simplicidad, propiedad total y cero nueva infraestructura:

• Cero cuentas nuevas que gestionar. Sin organización npm, sin rotación de NPM_TOKEN, sin recuperación de 2FA, sin ansiedad por la permanencia de publicación de 72 horas. El repositorio ES el artefacto, de principio a fin.

• Pruebas basadas en ramas gratis. ¿Quieres probar una rama de características? Solo cambia el fragmento a #feat/nombre-de-la-rama — listo. Con npm tendrías que publicar una etiqueta de pre-lanzamiento que vive en el registro para siempre.

• La misma autenticación que los usuarios ya tienen. Este repositorio es público; los miembros del equipo tienen acceso a GitHub; nada nuevo que configurar.

• Retraso de instalación marginal. El primer inicio es ~5–10 s de clonación + compilación frente a ~2–5 s para npm. Los inicios en caché son idénticos.

Compromisos que aceptamos: una UX de fijación de versiones menos pulida (etiquetas Git frente a rangos semver) y sin capacidad de descubrimiento en npm público. El razonamiento completo vive en docs/architecture.md.

Desarrollo local

git clone https://github.com/atri-jar/aurum-mcp.git
cd aurum-mcp
pnpm install
pnpm dev          # run the server via tsx + stdio
pnpm inspect      # spawn the official MCP Inspector UI
pnpm build        # tsc → dist/
pnpm smoke        # end-to-end tools/list + tools/call test

El servidor lee data/manifest.json (confirmado). Para obtener el último manifiesto de la galería Aurum en vivo y actualizar la copia empaquetada:

make manifest-fetch

CI hace esto automáticamente (ver .github/workflows/sync-manifest.yml).

Arquitectura en un párrafo

El sistema de diseño Aurum vive en Changejarapp/aurum-android (privado) y envía una galería pública a changejarapp.github.io/aurum-android. Su script tooling/gallery/generate.py agrega componentes, tokens, iconos, mapeos de Code Connect y el registro de cambios desde un único conjunto de analizadores. Añadimos una bandera --emit-manifest que produce una proyección JSON estructurada de los mismos datos — el contrato es tooling/manifest/schema.json en aurum-android. Este servidor MCP es el lado de lectura del JSON: carga el manifiesto al arrancar, lo indexa y proporciona las 9 herramientas anteriores. Una única fuente de verdad, dos objetivos de renderizado (HTML para humanos, JSON para agentes). Cuando aurum-ios se lance, su manifiesto se conectará como una fuente hermana — el código MCP es independiente de la plataforma.

Diagrama completo del pipeline: docs/architecture.md.

Contribución

Las incidencias y PRs son bienvenidas. Consulta docs/contributing.md para el flujo de trabajo (sincronización de manifiesto, verificación de deriva, proceso de lanzamiento). Estilo de código: TypeScript estricto, valores predeterminados de Prettier; sin lógica de negocio en formateadores de markdown.

Licencia

MIT — ver LICENSE.