MCP server de HyperWeave
Commit 15 sept 2026Permite que un cliente de IA componga diagramas, gráficos y tablas SVG deterministas con metadatos legibles por máquina integrados.
También conocido como InnerAura/hyperweave
- Stars
- 61
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 15 sept 2026
- Licencia
- Apache-2.0
¿Qué es HyperWeave MCP?
HyperWeave es un MCP server. Permite que un cliente de IA componga diagramas, gráficos y tablas SVG deterministas con metadatos legibles por máquina integrados.
Resumen generado a partir del README del proyecto
Acerca del MCP server de HyperWeave
Generar artefactos visuales deterministas como diagramas, gráficos y tablas a partir de especificaciones estructuradas es lo que hyperweave permite a los agentes de IA y desarrolladores. Al convertir JSON legible por máquina en archivos SVG autónomos, proporciona una forma para que los agentes comuniquen información compleja visualmente sin depender de un HTML frágil o imágenes rasterizadas pesadas. Estos SVG incluyen metadatos integrados, lo que permite a un agente volver a leer la estructura exacta que dibujó originalmente.
Los usuarios pueden interactuar con el sistema a través de una CLI, una API HTTP o un MCP server. La herramienta está diseñada con una filosofía de cero dependencias, lo que significa que no requiere JavaScript ni tiempo de ejecución para renderizarse, haciendo que los archivos resultantes sean compatibles con cualquier entorno que admita etiquetas de imagen estándar. Soporta varias topologías de diagramas, incluyendo pipelines, máquinas de estado, árboles y grafos acíclicos dirigidos (DAGs). Debido a que los artefactos llevan su propia especificación y resúmenes verificados mediante hash, pueden utilizarse para memoria duradera, comparaciones semánticas (diffing) o auditoría del linaje de mutación a través de diferentes pasos en un flujo de trabajo de agentes.
Qué puedes hacer con él
- 1Visualizar topologías de sistemas complejosUn agente puede generar una representación visual de un enrutador de modelos o un pipeline de servicios utilizando tipos de diagramas específicos.
- 2Mantener memoria duradera del agenteLos desarrolladores pueden usar los artefactos generados como una forma de almacenar estados que persistan fuera de la ventana de contexto inmediata.
- 3Realizar comparaciones visuales semánticasPuedes comparar dos salidas visuales diferentes basándote en sus datos subyacentes en lugar de comparar píxeles.
- 4Habilitar capacidades de lectura para agentesUn cliente de IA puede extraer los datos estructurados originales de un SVG para comprender el diagrama que creó previamente.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleinneraura/hyperweave is public and reachablegithub.com/inneraura/hyperweave ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-15github.com/inneraura/hyperweave ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubWhat Is HyperWeave
HyperWeave is a visual CLI for agents. Structured spec in, deterministic SVG out. Artifact classes include diagrams, charts, tables, and more. Each SVG is self-contained, with layout, theme, and machine-readable metadata compiled into the file.
Why It Exists
Humans can't keep pace with the volume of text agents produce. Pictures are the obvious fix, and every picture format gives something up. Markdown is portable but flat. HTML is expressive but fragile. Raster images travel well but discard their structure. Model output is flexible but never twice the same.
A HyperWeave artifact carries its own spec, so the thing your agent drew is the thing your agent can read back. Useful as:
- Chained steps: one agent's output is the next one's typed input.
- Memory: a committed artifact is durable state that survives the context window.
- Diffs: compare two artifacts semantically, not pixel by pixel.
- Audit: the spec, its provenance, and its mutation lineage travel with the image.
The picture is the record.
Philosophy
- Zero JavaScript.
- No runtime.
- No dependencies.
- One file, one request.
- Renders anywhere an
<img>tag does.
Artifact Format Comparison
| FORMAT | Portability | Agent-Readable Metadata | Visual Fidelity | Token Efficiency | Zero Dependencies | SCORE |
|---|---|---|---|---|---|---|
| SVG | ✓ | ✓ | ✓ | ~ | ✓ | 4.5 |
| Markdown | ~ | ~ | ✗ | ✓ | ✓ | 3.0 |
| HTML | ✗ | ✓ | ✓ | ✗ | ~ | 2.5 |
✓ full · ~ partial · ✗ none
Artifact Classes
Diagrams
Diagrams encode topology, not pixels. HyperWeave supports the following diagram types: pipeline, fanout, fanin, hub, cycle, loop, dag, lanes, state-machine, sequence, tree, and comparison. Nodes carry brand logo glyphs, labels, and tags. Edges carry labels and motion to help process information better. Every diagram renders as a self-contained SVG with its full spec and hash-verified digest embedded for agents to read directly. Render them in a markdown file, send to Slack as an image, or render directly in your terminal.
hyperweave compose diagram --spec-file /dev/stdin -g primer --variant porcelain --surface inlay --face light -o provider-router-light.svg <<'JSON'
{
"topology": "fanout",
"orientation": "horizontal",
"title": "One call, best model",
"subtitle": "Fanout · horizontal",
"zones": ["router", "providers"],
"node_style": "card+glyph",
"glyph_tint": "full",
"nodes": [
{ "id": "router", "label": "model router", "desc": "1 call, best model\ncapability-routed", "role": "hero", "kind": "router", "gather": true },
{ "id": "claude", "label": "Claude", "desc": "long-context", "glyph": "anthropic" },
{ "id": "gemini", "label": "Gemini", "desc": "multimodal", "glyph": "gemini" },
{ "id": "openai", "label": "OpenAI", "desc": "tool-use", "glyph": "openai" },
{ "id": "deepseek", "label": "DeepSeek", "desc": "reasoning", "glyph": "deepseek" },
{ "id": "kimi", "label": "Kimi", "desc": "agentic", "glyph": "kimi" },
{ "id": "qwen", "label": "Qwen", "desc": "multilingual", "glyph": "qwen" }
],
"edges": [
{ "source": "router", "target": "claude", "label": "route", "label_style": "chip", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "gemini", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "openai", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "deepseek", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "kimi", "relation": "drift", "marker": "arrow" },
{ "source": "router", "target": "qwen", "relation": "drift", "marker": "arrow" }
]
}
JSON
hyperweave extract broadcast-split-light.svg --respond payload > broadcast-split.json
hyperweave compose diagram --spec-file broadcast-split.json -g primer --variant porcelain --surface inlay --face light -o broadcast-split-light.svg
hyperweave extract compose-gate-light.svg --respond payload > compose-gate.json
hyperweave compose diagram --spec-file compose-gate.json -g primer --variant porcelain --surface inlay --face light -o compose-gate-light.svg
hyperweave compose diagram --spec-file pipeline-row -g primer --variant space --surface inlay --face light -o mcp-gateway-light.svg
pipeline-row is a bundled preset; the URL API renders it by name at /v1/diagram/pipeline-row/primer.static.
hyperweave extract verbs-mouth-light.svg --respond payload > verbs-mouth.json
hyperweave compose diagram --spec-file verbs-mouth.json -g primer --variant porcelain --surface inlay --face light -o verbs-mouth-light.svg
hyperweave compose diagram --spec-file dag-providers -g primer --variant noir --surface inlay --face light -o frontier-serving-light.svg
dag-providers is a bundled preset; the URL API renders it by name at /v1/diagram/dag-providers/primer.static.
hyperweave compose diagram --spec-file cycle-flow -g primer --variant porcelain --surface inlay --face light -o cycle-flow-light.svg
cycle-flow is a bundled preset; the URL API renders it by name at /v1/diagram/cycle-flow/primer.static.
hyperweave compose diagram --spec-file loop-hillclimb-turn -g primer --variant porcelain --surface inlay --face light -o loop-hillclimb-turn-light.svg
loop-hillclimb-turn is a bundled preset; the URL API renders it by name at /v1/diagram/loop-hillclimb-turn/primer.static.
hyperweave compose diagram --spec-file tree-health -g primer --variant porcelain --surface inlay --face light -o tree-health-light.svg
tree-health is a bundled preset; the URL API renders it by name at /v1/diagram/tree-health/primer.static.
Pick a layout
| Flows | pipeline · fanout · fanin |
stages in a line, one-to-many, many-to-one |
| Cycles | cycle · loop · state-machine |
a closed ring, a procedural loop with exits, legal state transitions |
| Structure | dag · tree · lanes |
dependencies, hierarchy, ownership rows |
| Centered | hub |
one thing at the middle of its world |
| Time | sequence |
who calls whom, in order |
| Side by side | comparison |
two options on one sheet |
Twelve layouts, fifty-nine bundled presets, one spec vocabulary. Variations are values of orientation, not layouts of their own:
dag · pipeline |
horizontal · vertical |
fanout |
horizontal · bilateral · upward · downward · radial |
tree |
horizontal · radial |
cycle |
ring · orbit |
loop |
vertical · horizontal |
fanin · hub · lanes · sequence · state-machine · comparison |
horizontal |
Render any preset by name at /v1/diagram/{preset}/primer.static, or run hyperweave discover diagram for every preset, orientation and field.
Matrices
HyperWeave matrices are structured tables rendered as portable SVGs. A single JSON description can produce comparison grids, registries, tiers, benchmark tables, heatmaps, chips, glyphs, bars, and status maps, while carrying a machine-readable payload for agents.
| READER | PIXELS | MOTION | READS VIA | |
|---|---|---|---|---|
| GitHub README | github | ✓ | Yes | camo, css animation |
| VS Code preview | vscode | ✓ | Yes | markdown preview |
| Slack unfurl | slack | ~ | - | image proxy |
| Gmail body | gmail | ~ | - | img tag |
| Agent | mcp | ✗ | - | hw:payload, hwz/1, markdown twin |
hyperweave compose matrix --spec-file /dev/stdin -g primer --variant porcelain -o one-artifact.svg <<'JSON'
{
"title": "One artifact. Many readers.",
"subtitle": "how each consumer ingests the same SVG",
"columns": [
{
"id": "reader",
"label": "READER",
"role": "label"
},
{
"id": "mark",
"label": "",
"kind": "glyph",
"glyph_tint": "full"
},
{
"id": "pixels",
"label": "PIXELS",
"kind": "check"
},
{
"id": "motion",
"label": "MOTION",
"kind": "pill"
},
{
"id": "via",
"label": "READS VIA",
"kind": "chip"
}
],
"rows": [
{
"label": "GitHub README",
"cells": [
{
"glyph": "github"
},
{
"state": "full"
},
{
"state": "on"
},
{
"chips": [
"camo",
"css animation"
]
}
]
},
{
"label": "VS Code preview",
"cells": [
{
"glyph": "vscode"
},
{
"state": "full"
},
{
"state": "on"
},
{
"chips": [
"markdown preview"
]
}
]
},
{
"label": "Slack unfurl",
"cells": [
{
"glyph": "slack"
},
{
"state": "partial"
},
{
"state": "off"
},
{
"chips": [
"image proxy"
]
}
]
},
{
"label": "Gmail body",
"cells": [
{
"glyph": "gmail"
},
{
"state": "partial"
},
{
"state": "off"
},
{
"chips": [
"img tag"
]
}
]
},
{
"label": "Agent",
"cells": [
{
"glyph": "mcp"
},
{
"state": "none"
},
{
"state": "off"
},
{
"chips": [
"hw:payload",
"hwz/1",
"markdown twin"
]
}
]
}
],
"notes": "pixels for humans · hw:payload for agents"
}
JSON
# Connectors preset
https://hyperweave.app/v1/matrix/connectors/primer.static?variant=porcelain
# Any table, one URL: base64url MatrixSpec JSON (8 KB cap)
https://hyperweave.app/v1/matrix/custom/primer.static?spec=<base64url>
Preguntas sobre HyperWeave MCP
¿Qué genera HyperWeave?
Produce diagramas, gráficos y tablas SVG deterministas a partir de una especificación estructurada, con el diseño, el tema y los metadatos compilados en cada archivo.
¿Requiere HyperWeave JavaScript?
No. Los artefactos son SVG puros sin JavaScript, sin tiempo de ejecución y sin dependencias, por lo que se renderizan en cualquier lugar donde funcione una etiqueta img.
¿Qué topologías de diagramas soporta HyperWeave?
Soporta topologías de pipeline, fanout, fanin, hub, cycle, loop, dag, lanes, state-machine, sequence, tree y comparison.
¿Puede un agente volver a leer los datos de un artefacto de HyperWeave?
Sí. Cada SVG integra su especificación completa y un resumen verificado mediante hash, que puede extraerse nuevamente como una carga útil estructurada.
¿Cómo utiliza un cliente de IA HyperWeave?
Puede llamar al motor de composición a través del MCP server, la API HTTP o la CLI.