VisualSpec

Name: VisualSpec
Author: utkarshx27

de utkarshx27versión 0.1.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.utkarshx27/visualspec

Instalar

Resumen

Descripción del creador (original en inglés)

Structured, constraint-aware visual generation and deterministic layout for AI agents

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: OPENAI_API_KEY, GEMINI_API_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: OPENAI_API_KEY, GEMINI_API_KEY

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "visualspec": {
      "command": "npx",
      "args": [
        "-y",
        "@utkarshx27/visualspec"
      ],
      "env": {
        "OPENAI_API_KEY": "your-value",
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add visualspec --env OPENAI_API_KEY=your-value --env GEMINI_API_KEY=your-value -- npx -y @utkarshx27/visualspec

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "visualspec": {
      "command": "npx",
      "args": [
        "-y",
        "@utkarshx27/visualspec"
      ],
      "env": {
        "OPENAI_API_KEY": "your-value",
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "visualspec": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@utkarshx27/visualspec"
      ],
      "env": {
        "OPENAI_API_KEY": "your-value",
        "GEMINI_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

OPENAI_API_KEY secreto env
Optional API key for OpenAI image generation
GEMINI_API_KEY secreto env
Optional API key for Google Gemini image generation

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub utkarshx27, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32433 servidores de esta categoría
Publicado en el registro más recientemente que el 40% de los otros 32433 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32433 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro VisualSpec?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: OPENAI_API_KEY, GEMINI_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.0) llegó al registro hace 2 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Symantec Cloud DLP AIops

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado ayer

Instalar

Symantec Cloud DLP AIops

de AIops-tools

Governed Symantec Cloud DLP — 14 MCP tools, read-only with audit.

Se ejecuta en tu computadoraActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

VisualSpec

Deterministic visual generation for AI agents.

AI creates the imagery. VisualSpec guarantees the typography and layout.

# Instant workspace setup (no clone required)

npx @utkarshx27/visualspec init

Launch local MCP Server for Cursor, Claude Desktop, or Antigravity

npx @utkarshx27/visualspec mcp

The Core Problem

Most image-generation workflows fail for social and marketing graphics because a single natural-language prompt is expected to handle too many concerns at once:

subject & background
exact typography & wording
platform dimensions & safe margins
visual hierarchy & negative space
brand color rules & constraints

Image models frequently hallucinate gibberish text, truncate words, or disregard composition rules.

The Solution: Layer Separation

VisualSpec separates generative concerns from deterministic concerns:

Generative Layers (AI Models): Photography, 3D subjects, atmospheric backgrounds, textures, lighting.
Deterministic Layers (Code & SVG Engine): Exact headlines, subtitles, badges, logos, metrics, safe margins, and layout rules.
Structured Visual Spec: A machine-readable YAML specification that acts as the single contract.
Visual QA & Targeted Repair: Verifies geometry, margins, and exact copy invariants, synthesizing localized repairs without regenerating entire scenes.

User Brief / Intent

│ ▼ Visual Spec (spec.yaml) │ ┌───┴──────────────┐ ▼ ▼ Platform Pack Template Pack │ │ └───┬──────────────┘ ▼ Spec Resolver │ ┌───┴───────────────────────┐ ▼ ▼ Model Adapter Deterministic Layout (Generative Base) (SVG Typography / Overlay) │ │ └───┬───────────────────────┘ ▼ Compositor (Sharp) │ ▼ Visual QA (Constraints, Safe Margins, Exact Copy) │ ├── PASS ──► Final Asset Bundle │ └── FAIL ──► Targeted Repair Planner

Documentation

Architecture & Design Principles
VisualSpec Schema & Contract
MCP Server Setup (Cursor, Claude, Antigravity)
Adding a New Image Model Provider
Contributing Guidelines

Quickstart

Instant Run (No Install Required)

# Initialize a new VisualSpec workspace

npx @utkarshx27/visualspec init

Launch local MCP Server for Cursor, Claude, or Antigravity IDE

npx @utkarshx27/visualspec mcp

Or Install Globally

npm install -g @utkarshx27/visualspec

Use CLI commands directly

visual init visual mcp

Or Build from Source

git clone https://github.com/utkarshx27/visualspec.git

cd visualspec npm install npm run build

1. Initialize a Project

npx @utkarshx27/visualspec init

2. Validate a Visual Spec

npx @utkarshx27/visualspec validate examples/product-launch/spec.yaml

3. Inspect the Compiled Generation Prompt

npx @utkarshx27/visualspec compile examples/product-launch/spec.yaml --provider openai

4. Deterministic Render (No API Key Required)

Render layout, typography, and background styling locally:

npx @utkarshx27/visualspec render examples/product-launch/spec.yaml --output ./output/demo-launch

5. Run the Full Generation Pipeline

npx @utkarshx27/visualspec generate examples/product-launch/spec.yaml --provider mock --output ./output/demo-launch

6. Verify Asset Quality with Visual QA

npx @utkarshx27/visualspec check ./output/demo-launch/final.png --spec examples/product-launch/spec.yaml

Model Context Protocol (MCP) Server

VisualSpec runs as a native MCP server over stdio, enabling AI coding assistants (Cursor, Claude Code, Gemini CLI, and Antigravity IDE) to invoke visual tools directly:

# Launch MCP server over stdio

npx @utkarshx27/visualspec mcp

Or if installed globally

visual mcp

Available MCP Tools

visual_brief_to_spec: Convert natural language requests into valid VisualSpec YAML.
visual_validate_spec: Schema validation for specs.
visual_render: Deterministic layout & typography rendering (zero API key).
visual_generate: Full image model adapter + deterministic text overlay pipeline.
visual_check_qa: Inspect safe margins, line counts, dimensions, and invariants.
visual_repair: Automated diagnosis and localized typography/layout repair.
visual_list_resources: List supported platform packs and templates.

See the MCP Setup Guide for Cursor, Claude Desktop, and Antigravity IDE configuration snippets.

Output Bundle

Every generation creates a complete, reproducible debug bundle:

output/demo-launch/

├── final.png # Platform-ready asset ├── visual-spec.yaml # Original input specification ├── resolved-spec.yaml # Full spec with platform & template rules applied ├── generation-request.json # Exact prompt and negative parameters sent to model ├── qa-report.json # Deterministic and constraint QA verification results └── metadata.json # Execution timestamps and file index

Supported Platforms & Templates

Platforms

Instagram: Feed portrait (1080x1350, 4:5), Square (1080x1080, 1:1), Story (1080x1920, 9:16).
LinkedIn: Feed portrait (1080x1350), Square (1080x1080), Banner (1200x628).
Generic Social: Universal 1:1, 4:5, and 16:9 social formats.

Templates

Product Launch: High-impact headline, feature pill, product visual region, supporting subhead.
Quote Card: Center-focused editorial quote, author attribution, minimal atmospheric glow.
Stat Card: Large numeric hero metric, descriptive label, and data context notes.

Agent Skills

The framework includes 10 standardized skill definitions located in ./skills/:

using-visualspec: Master workflow instructions.
visual-brief: Brief extraction and analysis.
visual-spec: YAML authoring and schema rules.
composition: Spatial hierarchy and negative space allocation.
typography: Font family classing and line budgeting.
strict-constraints: Invariant taxonomy and forbidden parameters.
social-instagram: Instagram-specific design reasoning.
social-linkedin: LinkedIn-specific design reasoning.
visual-qa: Automated inspection and validation.
visual-repair: Localized diagnosis and patch generation.

Roadmap & Open Contributions

We welcome contributions! Key areas to build together:

Additional Platforms: X/Twitter (Header, Post), YouTube Thumbnails, Pinterest, TikTok Cover.
Additional Templates: Testimonial, Product Comparison, Event Announcement, Feature List.
Additional Image Model Adapters: Flux, Stable Diffusion / ComfyUI, Midjourney API.
Brand Packs: Multi-brand palette overrides, custom font loading, logo clear space rules.
Visual Studio: Local web playground / viewer for real-time spec inspection and margin toggling.

Contributing

Contributions are welcome! Please check our:

Contributing Guidelines
Code of Conduct

Testing

Run the automated test suite:

npm test

All 28 tests run offline without requiring any third-party API keys.

License

Licensed under the Apache License, Version 2.0.

VisualSpec

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Symantec Cloud DLP AIops

README del creador

VisualSpec

Launch local MCP Server for Cursor, Claude Desktop, or Antigravity

The Core Problem

The Solution: Layer Separation

Documentation

Quickstart

Instant Run (No Install Required)

Launch local MCP Server for Cursor, Claude, or Antigravity IDE

Or Install Globally

Use CLI commands directly

Or Build from Source

1. Initialize a Project

2. Validate a Visual Spec

3. Inspect the Compiled Generation Prompt

4. Deterministic Render (No API Key Required)

5. Run the Full Generation Pipeline

6. Verify Asset Quality with Visual QA

Model Context Protocol (MCP) Server

Or if installed globally

Available MCP Tools

Output Bundle

Supported Platforms & Templates

Platforms

Templates

Agent Skills

Roadmap & Open Contributions

Contributing

Testing

License