Serveur MCP HyperWeave
Commit 15 sept. 2026Permet à un client IA de composer des diagrammes, des graphiques et des tableaux SVG déterministes avec des métadonnées exploitables par machine intégrées.
Aussi connu sous InnerAura/hyperweave
- Étoiles
- 61
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 15 sept. 2026
- Licence
- Apache-2.0
Qu'est-ce que HyperWeave MCP ?
HyperWeave est un serveur MCP. Permet à un client IA de composer des diagrammes, des graphiques et des tableaux SVG déterministes avec des métadonnées exploitables par machine intégrées.
Résumé généré à partir du README du projet
À propos du MCP server HyperWeave
La génération d'artefacts visuels déterministes tels que des diagrammes, des graphiques et des tableaux à partir de spécifications structurées est ce que hyperweave permet aux agents IA et aux développeurs. En convertissant du JSON lisible par machine en fichiers SVG autonomes, il offre aux agents un moyen de communiquer des informations complexes visuellement sans dépendre d'un HTML fragile ou d'images raster lourdes. Ces SVG incluent des métadonnées intégrées, permettant à un agent de relire la structure exacte qu'il a initialement dessinée.
Les utilisateurs peuvent interagir avec le système via un CLI, une API HTTP ou un MCP server. L'outil est conçu selon une philosophie sans dépendance, ce qui signifie qu'il ne nécessite ni JavaScript ni runtime pour le rendu, rendant les fichiers résultants compatibles avec n'importe quel environnement prenant en charge les balises d'image standard. Il prend en charge diverses topologies de diagrammes, notamment les pipelines, les machines à états, les arbres et les graphes orientés acycliques (DAG). Comme les artefacts transportent leur propre spécification et des condensés vérifiés par hash, ils peuvent être utilisés pour une mémoire durable, une comparaison sémantique (diffing) ou l'audit de la lignée des mutations à travers les différentes étapes d'un flux de travail agentique.
Ce que vous pouvez faire avec
- 1Visualiser des topologies de systèmes complexesUn agent peut générer une représentation visuelle d'un routeur de modèle ou d'un pipeline de service en utilisant des types de diagrammes spécifiques.
- 2Maintenir une mémoire d'agent durableLes développeurs peuvent utiliser les artefacts générés comme moyen de stocker un état qui persiste en dehors de la fenêtre de contexte immédiate.
- 3Effectuer des comparaisons visuelles sémantiquesVous pouvez comparer deux sorties visuelles différentes en vous basant sur leurs données sous-jacentes plutôt qu'en comparant les pixels.
- 4Permettre des capacités de relecture agentiquesUn client IA peut extraire les données structurées originales d'un SVG pour comprendre le diagramme qu'il a précédemment créé.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleinneraura/hyperweave is public and reachablegithub.com/inneraura/hyperweave ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-15github.com/inneraura/hyperweave ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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>
Questions sur HyperWeave MCP
Que génère HyperWeave ?
Il produit des diagrammes, des graphiques et des tableaux SVG déterministes à partir d'une spécification structurée, avec la mise en page, le thème et les métadonnées compilés dans chaque fichier.
HyperWeave nécessite-t-il JavaScript ?
Non. Les artefacts sont du SVG pur sans aucun JavaScript, sans runtime et sans dépendances, ils s'affichent donc partout où une balise img fonctionne.
Quelles topologies de diagrammes HyperWeave prend-il en charge ?
Il prend en charge les topologies de type pipeline, fanout, fanin, hub, cycle, loop, dag, lanes, state-machine, sequence, tree et comparison.
Un agent peut-il relire les données d'un artefact HyperWeave ?
Oui. Chaque SVG intègre sa spécification complète et un condensé vérifié par hash, qui peut être extrait à nouveau sous forme de charge utile structurée.
Comment un client IA utilise-t-il HyperWeave ?
Il peut appeler le moteur de composition via le MCP server, l'API HTTP ou le CLI.