Septima Widget MCP Server
rastermanden/widget-mcp-server
Configure widgets Septima via linguagem natural com validação e exemplos semânticos
Ver no GitHubServidor MCP em Rust que permite criar configurações JSON válidas para widgets Septima através de linguagem natural. Combina validação de schema com busca semântica em 520 exemplos reais e integração com catálogos de dados e serviços WFS/WMS.
Instalação
npx convez-ai rastermanden/widget-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar configs de widgets complexos sem memorizar estrutura JSON
- Validar e corrigir iterativamente configurações via feedback estruturado
- Descobrir e integrar camadas de serviços WFS/WMS em widgets
Veredito

Ferramenta especializada e bem-arquitetada para o ecossistema Septima/plandata.dk. A combinação de schema validation + busca semântica em exemplos reais cria um loop confiável para geração de configs complexas. Recomendado para equipes trabalhando com widgets Septima em produção.
README
A tradução para o português deste README ainda está na fila.
Septima Widget Configuration — MCP Server
Idéen
Septima Widget konfigureres via JSON. Formatet er komplekst — hundredvis af
mulige felter, indlejrede strukturer, enums og $ref-afhængigheder — og for
stort til at en LLM kan huske præcist fra træningsdata alene.
Denne MCP-server løser det ved at give agenten to komplementære informationskilder:
JSON Schema beskriver hvad der er gyldigt: hvilke felter der findes, deres
typer, tilladte værdier og hvilke kombinationer der er lovlige. Validering med
præcise fejlstier (/map/layer/0/type) gør det muligt at iterere mod en korrekt
config uden at gætte.
Eksempler viser hvad der virker i praksis: 520 rigtige, validerede widget-configs dækker kombinationer af lag, kontroller, styling og datakilder som skemaet ikke kan formidle alene. Semantisk søgning (fastembed embeddings + cosinus-lighed) finder de nærmeste eksempler til en natursprogsbeskrivelse, så agenten kan adaptere en rigtig config fremfor at opfinde strukturen fra bunden.
Kombinationen giver agenten en præcis feedback-loop: hent et eksempel der ligner → tilpas det → valider → ret fejl → gentag. Det er denne loop der gør det muligt at producere valide configs reliabelt over naturlig sprog.
An MCP server that lets an LLM author valid Septima Widget JSON configs over natural language. It exposes the schema, validates drafts with structured per-field errors, retrieves semantically similar examples, and searches the DMP datakatalog for layers. The draft → validate → fix loop is what makes natural-language authoring reliable.
Tools
| Tool | Purpose |
|---|---|
get_examples | Semantic search over 520 real validated configs. Pass a natural-language description; returns closest matches. |
validate_config | Validates a draft; returns {valid:true} or errors with JSON-pointer path + message. |
get_schema_for | Returns a sub-section of the schema by JSON Pointer path (much smaller than full schema). |
get_schema | Full widget schema with all $refs resolved — use only when you need an overview. |
get_starter_config | Minimal valid config to build on (map or data). |
search_dmp_catalogue | AI search over DMP's datakatalog. Returns urn:dmp:ds:… layer IDs. |
inspect_features_host | Fetches a WFS/GeoJSON URL and returns field names + sample values + a template_info suggestion. |
inspect_service | Fetches WFS and/or WMS GetCapabilities. Returns all layers and suggests WMS-only, WFS-only and combined configs. |
Recommended workflow
get_schema_for— look up the exact shape of the concept you need (layer item, control, style, view). Always consult the schema first.get_examples— find the closest real config to adapt from.- Draft a config combining schema knowledge with the example.
validate_config— fix any errors, repeat until valid.search_dmp_catalogue— look up DMP layer URNs when adding DMP layers.inspect_service— discover layers on a WFS/WMS service before authoring a config.inspect_features_host— inspect a WFS URL to get field names before writingtemplate_info.
Example prompts
These prompts work well with Claude Code connected to this MCP server.
Discover and pick layers from a service
Vis mig hvilke lag der er på https://geoserver.plandata.dk/geoserver/wfs
Vis mig lag fra https://geoserver.plandata.dk/geoserver/wfs og lav et widget
med lokalplan vedtaget — kombineret WMS og klik-info
Vis lag fra https://kortforsyningen.kms.dk/... og lad mig vælge
Plandata (WMS + features_infohost pattern)
Lav et widget med lokalplan_vedtaget fra plandata med klik-popup der viser
plannavn, kommune, anvendelse og link til plandokument
Lav et widget med kommuneplanramme og lokalplan fra plandata — begge med
klik-info og highlight ved selektion
Lav et widget med lokalplandelområder og kommuneplanrammer vedtaget,
print-knap og fullscreen
DMP layers
Find DMP-lag med nitratfølsomme indvindingsområder og lav et widget
Find DMP-lag med fredede fortidsminder og lav et widget med layergroup-kontrol
Søg efter grundvandsbeskyttelse i DMP og tilføj laget til et widget
WFS vector layers with info popup
Lav et widget med WFS GML lag fra plandata — hent felter og lav info popup
Lav et widget med GeoJSON lag hentet fra en URL med klik-popup
Lav et widget med inline GeoJSON punktlag med navn, adresse og link i popup
Controls and layout
Lav et widget med print, fullscreen og layer switcher (layergroup)
Lav et widget med adressesøgning og geolokation
Tilføj print og fullscreen til dette widget: { ... }
Adapt and extend
Tilføj et DMP-lag med lavbundsarealer til dette widget: { ... }
Skift baselaget til ortofoto i dette widget: { ... }
Valider denne config og ret eventuelle fejl: { ... }
Build
cargo build --release
Produces two binaries in target/release/:
| Binary | Purpose |
|---|---|
septima-widget-mcp | MCP server (stdio transport) |
build_db | Recompute embeddings and repopulate examples.db |
Populating the example database
Examples are embedded at startup using fastembed (AllMiniLML6V2) and stored in a SQLite database so the server starts in ~1 s instead of ~28 s.
Run build_db once after adding or removing examples, then commit examples.db:
./target/release/build_db # writes examples.db in current dir
./target/release/build_db /path/to/out.db # custom path
The build takes ~30 s (embedding 519 configs). The result is 2.6 MB.
Running the server
# stdio mode (default)
./target/release/septima-widget-mcp
./target/release/septima-widget-mcp --db /path/to/examples.db
# HTTP/SSE mode
./target/release/septima-widget-mcp --http 3456
./target/release/septima-widget-mcp --http 3456 --db /path/to/examples.db
The server fetches the widget schema from the CDN at startup
(https://widget.cdn.septima.dk/dev/schema/widget.schema.json) and resolves all
~46 $ref files into one in-memory document. Requires network access to
widget.cdn.septima.dk.
Wire into Claude Code / Claude Desktop
Two transport modes are supported. Pick one.
stdio (recommended for local use)
.mcp.json:
{
"mcpServers": {
"septima-widget-mcp": {
"command": "/absolute/path/to/target/release/septima-widget-mcp",
"args": ["--db", "/absolute/path/to/examples.db"]
}
}
}
HTTP/SSE (useful when the server runs remotely or as a persistent process)
Start the server once:
./target/release/septima-widget-mcp --http 3456
.mcp.json:
{
"mcpServers": {
"septima-widget-mcp": {
"url": "http://localhost:3456/sse"
}
}
}
In HTTP mode the server keeps running until interrupted (Ctrl-C). Multiple
clients can connect simultaneously; each gets its own server instance.
DMP layers
search_dmp_catalogue queries DMP's AI-search API and returns entity IDs of the
form urn:dmp:ds:<slug>. Use these directly as namedlayer in a layer entry:
{ "id": "nitrat", "name": "Følsomme indvindingsområder", "visible": false,
"namedlayer": "urn:dmp:ds:foelsomme-indvindingsomraader-mst" }
Entity type ds = single dataset (use as namedlayer).
Entity type dscol / dsgroup = collections — cannot be used directly as a layer.
Codebase
src/
lib.rs — shared: embedding helpers, ExampleRecord, load_examples, build_db
main.rs — MCP server and all tool implementations
schema.rs — CDN fetch + $ref resolution
bin/
build_db.rs — thin wrapper that calls lib::build_db
examples/ — 519 validated widget config JSON files (embedded at compile time)
examples.db — pre-computed embeddings (generated by build_db, committed)
Notes
- stdout is the MCP channel. Never
println!to stdout; usetracing(→ stderr). - Schema gap:
mapanddataare described as mutually exclusive but the schema does not enforce it. Add"not": {"required": ["map","data"]}upstream to enforce it. - Remote hosting: stdio suits local clients. Switch to the streamable-HTTP transport for remote use.