Skip to main content
Glama
abedell-g2

Frontend Guru MCP

by abedell-g2

Frontend Guru MCP

Transform designs to Elevate 2.0 design system - MCP server + web interface

šŸŽÆ What This Does

Takes design inputs (URLs, screenshots, descriptions) and transforms them into production-ready React components that follow G2's Elevate 2.0 design system.

Two interfaces:

  • MCP Server - For Claude Code users (CLI + Desktop tab)

  • Web Interface - For everyone else (GUI, zero setup)


Related MCP server: stitch-pro-mcp

šŸš€ Quick Start

For Claude Code Users (MCP Server)

1. Install dependencies:

npm install
npm run build

2. Configure Claude Code/Desktop:

Add to your MCP config file:

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json Claude Code: ~/.claude/mcp_servers.json

{
  "mcpServers": {
    "frontend-guru": {
      "command": "node",
      "args": ["/Users/abedell/Developer/frontend-guru-mcp/dist/mcp/index.js"]
    }
  }
}

3. Restart Claude

4. Use it:

/frontend-guru https://example.com

Claude will ask you questions about format, then run the transformation.


For Web Interface Users

Coming soon - Will be deployed to: https://g2-frontend-guru.vercel.app


šŸ“ Project Structure

src/
ā”œā”€ā”€ core/              # Shared logic (used by both MCP and web)
│   ā”œā”€ā”€ agents/        # Agent prompts (orchestrator, analyzer, planner, etc.)
│   ā”œā”€ā”€ orchestrator/  # Transformation workflow
│   └── exports/       # Output format handlers
ā”œā”€ā”€ mcp/               # MCP server (Claude Code)
└── web/               # Web interface (Next.js) - TODO

šŸ”§ Development

Run MCP server in dev mode:

npm run dev:mcp

Build everything:

npm run build

šŸ“ Next Steps (TODO)

  • Complete web interface (Next.js app in src/web/)

  • Deploy web interface to Vercel

  • Implement actual agent workflow integration (currently returns mock data)

  • Add export handlers (ZIP, preview URL, clipboard)

  • Add progress tracking for long builds

  • Add build history/listing


šŸŽ“ How It Works

  1. User provides input (URL, screenshot, or description)

  2. Analyzer agent identifies all sections in the design

  3. Planner agent creates optimal build plan

  4. Builder agent transforms design to React code (with design system rules)

  5. Validator agent checks completeness and compliance

  6. Refiner agent fixes any design system violations

  7. Export in requested format (React, ZIP, preview, clipboard)

All agents follow the "transformation mindset" - adapting designs to match Elevate 2.0 standards, not just copying them.


šŸ“š Documentation

  • Agents: See src/core/agents/ for all agent prompts

  • Design System Rules: See src/core/agents/frontend-guardian.md for all 41 rules

  • Orchestrator: See src/core/agents/orchestrator.md for workflow


šŸ†˜ Troubleshooting

MCP server not showing up in Claude:

  1. Check config file path is correct

  2. Verify file has valid JSON (no trailing commas)

  3. Restart Claude completely

  4. Check logs: MCP server logs to stderr

Build fails:

  • Ensure all agents are present in src/core/agents/

  • Check that Node.js version is 18+ (node --version)


šŸ“„ License

Private - G2 internal use only

Available Tools

1 tool
frontend_guru_transformA

Transform a design (URL, screenshot, or description) to Elevate 2.0 design system compliant React code

ParametersJSON Schema
NameRequiredDescriptionDefault
sourceYesURL, screenshot path, or design description
formatNoOutput formatreact

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It only states a transformation happens, omitting behavioral traits such as idempotency, side effects, authentication needs, or whether the input is consumed destructively.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, highly concise and front-loaded with the core action. No redundant words; every part contributes to understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given low complexity (2 params, no output schema), the description covers the essential purpose and input format. However, it could mention output format details or constraints (e.g., only React output).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, reaching baseline of 3. The description does not add meaning beyond the schema; both 'source' and 'format' are already well-documented in the input schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Transform') and resource ('design') with a clear outcome: 'Elevate 2.0 design system compliant React code'. It distinguishes the tool's purpose without needing sibling differentiation as none exist.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool vs alternatives, nor prerequisites or exclusions. Usage is implied from the transformation purpose, but lacks clarity on context like preferred input types or output limitations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.0
    • First observedfrontend_guru_transform

TDQS

A3.6/5.0
Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools.

Naming Consistency5/5

The single tool name follows a clear verb_noun pattern (frontend_guru_transform) with no inconsistency.

Tool Count2/5

One tool is too few for a comprehensive design-to-code server. Typical scopes would require multiple tools for different aspects (e.g., validation, customization, export).

Completeness2/5

The single tool covers only the transformation step, lacking essential operations like validating outputs, adjusting parameters, or managing multiple designs. The surface is severely incomplete for the stated purpose.

Maintenance

ActivityStale
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables the generation and iterative refinement of React UI components from natural language descriptions or design images using Vercel's v0 API. It provides tools for design-to-code workflows and chat-based component development within Claude, Cursor, and other MCP environments.
    4
    16
    20
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    An intelligent MCP server for Google Stitch that generates production-ready UI from text prompts, with auto-orchestration of design systems, WCAG accessibility, responsive breakpoints, and framework conversion (React, Vue, Svelte).
    17
    11
    8
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    An MCP server that drives Anthropic's Claude Design from agentic coding CLIs, providing tools to create, generate, iterate, and export design systems without a browser.
    32
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Automated MCP server for the Insider Design System. Enables AI assistants to discover, understand, and generate code for over 60 Design System components with automated extraction from source code.
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/abedell-g2/frontend-guru-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server