Skip to main content
Glama
moonvy-ui-mcp

moonvy-ui-mcp

by Cc-Zzh1

Moonvy UI MCP

MCP zum Lesen von Moonvy-Designs für die Frontend-Entwicklung. Durch Eingabe einer Projektseiten- oder Designdatei-URL können Seitenliste, Artboard-Größen, Layer-Baum, Knotenstile, Design-Tokens sowie Slice-/Snapshot-/Bildfüll-Ressourcen abgerufen werden.

Dieses Projekt orientiert sich an den Tool-Grenzen von lanhu-mcp, liest die Daten jedoch speziell für Moonvy: Es extrahiert präzise Parameter aus den Moonvy-Designdatendateien (Genome), anstatt Farben, Schriftgrößen und Abstände anhand von Screenshots zu erraten.

Funktionen

MCP-Tool

Zweck

moonvy_parse_url

Projekt-, Verzeichnis- und Designdatei-IDs parsen

moonvy_list_pages

Designdateien aus Projekt/Verzeichnis auflisten; nur bei Ordner-URLs zuerst aufrufen

moonvy_get_design

Titel, Artboard-IDs, Artboard-Breite/-Höhe, Genome-Version abrufen

moonvy_list_layers

Flache Layer-Indizes zum Auffinden von Knoten-IDs nach Namen

moonvy_get_node_style

Größe, relative Koordinaten, Abstände, Füllung, Text, Eckenradius, Kontur, Schatten und CSS eines einzelnen Knotens abrufen

moonvy_get_tree

Verschachtelten Layer-Baum mit UI-Parametern abrufen

moonvy_extract_tokens

Farben, Verläufe, Schriften, Schriftgrößen, Schriftgewichte, Zeilenhöhen, Eckenradien, Schatten und abgeleitete Abstände extrahieren

moonvy_get_ui_spec

Gibt Metadaten, Tokens und Layer-Baum mit Stilen in einem Aufruf zurück; für die Entwicklung empfohlen

moonvy_download_asset

Slice, Snapshot, Bildfüllung oder Dateivorschau der obersten Ebene herunterladen

moonvy_clear_cache

In-Memory-Cache nach Design-Updates leeren

moonvy_get_node_style und moonvy_get_ui_spec liefern:

  • Absolute Position sowie relativeX / relativeY relativ zum übergeordneten Knoten

  • Abstand zur rechten und unteren Kante des übergeordneten Knotens

  • Breite/Höhe, Sichtbarkeit, Deckkraft, Beschneidungsstatus

  • Verweise auf Volltonfarben, Verläufe und Bildfüllungen

  • Schriftart, Schriftgröße, Schriftgewicht, Zeilenhöhe, Zeichenabstand, Textfarbe und Ausrichtung

  • Eckenradius, Kontur, Schatten

  • Direkt referenzierbares CSS-Eigenschaftenobjekt

Related MCP server: figma-mcp-server

Datenpfad

Moonvy URL
  -> projectId / dirId / fileId
  -> POST https://global-api.moonvy.com/v2/anynode/get
  -> files.genome.url
  -> 下载并解压 Genome JSON
  -> 解析图层、样式、Token、资源
  -> MCP JSON 响应

Projekt-/Verzeichnislisten verwenden POST /v2/anynode/list. Dies sind nicht-öffentliche Schnittstellen, die derzeit von Moonvy Web verwendet werden. Sollte Moonvy die Schnittstellen oder die Genome-Struktur in Zukunft anpassen, muss die Anpassungsschicht synchron aktualisiert werden.

Installation

Erfordert Node.js 20 oder höher.

cd C:\path\to\moonvy-ui-mcp
npm install
Copy-Item .env.example .env

Moonvy-Anmeldetoken konfigurieren

  1. Bei Moonvy im Browser anmelden und die zu lesende Moonvy-Seite öffnen.

  2. Die Entwicklertools öffnen und zur Konsole wechseln.

  3. Ausführen:

copy(window.app?.api?.$options?.token)
  1. Den kopierten Wert in die .env-Datei dieses Projekts schreiben:

MOONVY_TOKEN=你的本机令牌

Das Token wird nur lokal gespeichert. Es darf nicht in Chats gesendet, in Git committet oder in Frontend-Code geschrieben werden. Die Dienstantworten blenden JWT und Ressourcen-URLs mit Abfrageparametern automatisch aus.

Selbsttest

npm run check
npm test
npm start

npm start ist ein stdio-MCP-Dienst, der normalerweise keine regulären Logs ausgibt und auf eine MCP-Client-Verbindung wartet.

Integration in Codex / ChatGPT-Desktop-App

In den Einstellungen MCP servers -> Add server wählen und den Typ STDIO auswählen:

  • Command: node

  • Arguments: C:\path\to\moonvy-ui-mcp\src\server.js

  • Working directory: C:\path\to\moonvy-ui-mcp

Alternativ kann Folgendes in ~/.codex/config.toml oder in eine .codex/config.toml innerhalb eines vertrauenswürdigen Projekts eingefügt werden:

[mcp_servers.moonvy]
command = "node"
args = ["C:/path/to/moonvy-ui-mcp/src/server.js"]
cwd = "C:/path/to/moonvy-ui-mcp"
startup_timeout_sec = 20
tool_timeout_sec = 180

Der Dienst liest MOONVY_TOKEN standardmäßig aus der .env-Datei im cwd. Falls das Token aus lokalen Umgebungsvariablen weitergeleitet werden soll, kann zusätzlich Folgendes hinzugefügt werden:

env_vars = ["MOONVY_TOKEN"]

Nach dem Speichern Codex/Desktop-App neu starten und im Eingabefeld /mcp verwenden, um die Verbindung zu prüfen.

Integration in Cursor / Windsurf / Claude Code

Standard-stdio-MCP-Konfiguration verwenden:

{
  "mcpServers": {
    "moonvy": {
      "command": "node",
      "args": ["C:/path/to/moonvy-ui-mcp/src/server.js"],
      "cwd": "C:/path/to/moonvy-ui-mcp"
    }
  }
}

Aktueller Link:

https://moonvy.com/project/89f75621-a0e7-4122-b9ee-b6b703e1c826/cf67c54c-8e2b-4809-9e4d-fc6512d0e0be

Er enthält projectId + dirId und zeigt auf einen Ordner statt auf eine konkrete Designdatei. Daher wird Folgendes empfohlen:

  1. moonvy_list_pages aufrufen, um die Dateiliste abzurufen.

  2. Eine konkrete Design-URL aus den zurückgegebenen Ergebnissen auswählen.

  3. moonvy_get_design aufrufen, um die Artboard-Liste anzuzeigen.

  4. Für das Ziel-Artboard moonvy_get_ui_spec mit maxDepth=4 und maxNodes=500 aufrufen.

  5. Falls ein bestimmtes Element genau geprüft werden soll, zuerst moonvy_list_layers verwenden, um die Knoten-ID zu finden, dann moonvy_get_node_style aufrufen.

  6. Icons, Hintergrundbilder oder Seiten-Snapshots mit moonvy_download_asset in das Ressourcenverzeichnis des tatsächlichen Frontend-Projekts herunterladen.

Beispiel-Prompt:

使用 Moonvy MCP 列出这个项目目录里的设计文件。找到“新增学生”页面后,
读取它的 UI spec,保留原始颜色、字号、间距和圆角,并把需要的切图下载到
C:/work/school-web/src/assets/moonvy。

Entsprechung zu lanhu-mcp

lanhu-mcp-Ansatz

Umsetzung in diesem Projekt

Designliste abrufen

moonvy_list_pages

Designparameter analysieren

moonvy_get_ui_spec / moonvy_get_node_style

Slices abrufen

moonvy_download_asset

Login-Berechtigung über Cookie/JWT wiederverwenden

MOONVY_TOKEN-Umgebungsvariable

Designdaten cachen

In-Process-Genome-TTL-Cache

Modellkontext steuern

frameId, maxDepth, maxNodes

Die aktuelle Version konzentriert sich auf „Design → Frontend-Implementierung" und übernimmt nicht die Anforderungsdokumentanalyse, das Team-Message-Board und die Feishu-Kollaborationsfunktionen aus dem Lanhu-Projekt.

Sicherheit und Einschränkungen

  • Nur Moonvy-Projekte verwenden, auf die Sie ohnehin Zugriffsrechte haben.

  • .env ist in .gitignore enthalten; dennoch sollte das Token nicht manuell committet werden.

  • moonvy_download_asset erfordert ein absolutes Ausgabeverzeichnis, um zu verhindern, dass Ressourcen versehentlich an unklare Orte geschrieben werden.

  • Nach Ablauf des Moonvy-Tokens muss es neu abgerufen werden.

  • Dieses Projekt umgeht keine Anmeldung, Projektberechtigungen oder Zugriffskontrollen des Moonvy-Servers.

  • Die Felder im Genome können je nach Design-Tool-Version leicht abweichen; der Parser behält gängige Kompatibilitätsfelder bei, dennoch wird eine End-to-End-Abnahme mit einem realen Team-Design empfohlen.

Entwicklung und Tests

Unit-Tests verwenden synthetische Genome und benötigen keine Moonvy-Anmeldedaten:

npm test

End-to-End-Tests mit echten Projekten erfordern ein gültiges MOONVY_TOKEN:

1. moonvy_list_pages(文件夹 URL)
2. moonvy_get_design(设计文件 URL)
3. moonvy_get_ui_spec(设计文件 URL)
4. moonvy_get_node_style(设计文件 URL, 节点 ID)

Available Tools

10 tools
moonvy_clear_cacheClear Moonvy genome cacheA

Clear the in-memory genome cache after a design has changed and must be fetched again.

Inputs: no named parameters.

moonvy_download_assetDownload Moonvy assetA

Download a design slice, snapshot, image fill, or top-level file/preview into an absolute local output directory.

Inputs: url (required), nodeId (required), outputDir (required), type, +2 more.

moonvy_extract_tokensExtract Moonvy design tokensB

Extract reusable colors, gradients, fonts, text metrics, radii, inferred padding/gaps, and shadows from a design.

Inputs: url (required).

moonvy_get_designGet Moonvy design metadataA

Return the design title, genome version, frame IDs, frame dimensions, and child counts for a Moonvy design URL.

Inputs: url (required).

moonvy_get_node_styleGet exact Moonvy node styleA

Return one node’s size, coordinates, distances to parent edges, fills, typography, borders, radius, effects, opacity, visibility, and directly usable CSS declarations.

Inputs: url (required), nodeId (required).

moonvy_get_treeGet Moonvy layer treeA

Return the nested design layer tree. Styles include exact UI values and CSS. Limit depth and node count to keep model context compact.

Inputs: url (required), frameId, maxDepth, maxNodes, +2 more.

moonvy_get_ui_specGet frontend-ready Moonvy UI specA

Recommended development tool: return design metadata, inferred design tokens, and a styled component tree in one response. Use frameId/maxDepth/maxNodes to control context size.

Inputs: url (required), frameId, maxDepth, maxNodes, +1 more.

moonvy_list_layersList Moonvy layersA

Return a flat layer index with node IDs, names, types, depth, absolute bounds, and parent-relative positions. Use it to find a node ID before requesting exact style.

Inputs: url (required), frameId, maxNodes, includeHidden.

moonvy_list_pagesList Moonvy project pagesA

List folders and design files below a Moonvy project or directory URL. Call this first when only a project URL is known.

Inputs: url (required), limit, maxApiPages.

moonvy_parse_urlParse Moonvy URLA

Validate a Moonvy URL and return project, directory, and file IDs. Does not require authentication.

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a distinct responsibility: URL parsing, listing pages, fetching design metadata, layer indexing, node style extraction, tree traversal, token extraction, full spec generation, asset download, and cache management. No two tools overlap in purpose, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent 'moonvy_verb_noun' pattern using snake_case (e.g., moonvy_list_pages, moonvy_get_node_style). The prefix uniformly identifies the server, and verbs are action-oriented with descriptive nouns, creating a predictable and readable API surface.

    Tool Count5/5

    With 10 tools, the server covers the core workflow of navigating Moonvy designs, extracting styles, tokens, specs, and assets without excess. The count is well-scoped for its purpose—neither too sparse nor bloated.

    Completeness4/5

    The tool surface covers the full design-to-code pipeline: parse URLs, navigate hierarchy, retrieve detailed node styles, extract tokens, generate UI specs, and download assets. A minor gap is the lack of tools for editing or creating designs, but given the read-focused nature of this server, the existing set is comprehensive and leaves no dead ends for typical usage.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables interaction with Figma files through intelligent API access, providing navigation, asset extraction, and design token retrieval with 95% token-optimized compact tree output format.
      15
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables developers to extract and organize Figma design files, including complete node data (tree structure and images) for AI understanding and code generation.
      23 PyPI
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides AI coding agents with structured access to Lanhu design data, enabling direct inspection of artboards, extraction of pixel-perfect layer styles and CSS attributes, and downloading of design assets without vision token overhead.
      9
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI clients to read design pages, screenshots, original assets, styles, and workflows from Lanhu, Figma, and Mockplus, inspect elements, download resources, and build local page-flow maps.
      23
      1
      MIT