convez.ai
MCP ServerDesenvolvimento WebAvançado
rastermanden

Septima Widget MCP Server

rastermanden/widget-mcp-server

Configure widgets Septima via linguagem natural com validação e exemplos semânticos

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-server

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

ToolPurpose
get_examplesSemantic search over 520 real validated configs. Pass a natural-language description; returns closest matches.
validate_configValidates a draft; returns {valid:true} or errors with JSON-pointer path + message.
get_schema_forReturns a sub-section of the schema by JSON Pointer path (much smaller than full schema).
get_schemaFull widget schema with all $refs resolved — use only when you need an overview.
get_starter_configMinimal valid config to build on (map or data).
search_dmp_catalogueAI search over DMP's datakatalog. Returns urn:dmp:ds:… layer IDs.
inspect_features_hostFetches a WFS/GeoJSON URL and returns field names + sample values + a template_info suggestion.
inspect_serviceFetches WFS and/or WMS GetCapabilities. Returns all layers and suggests WMS-only, WFS-only and combined configs.

Recommended workflow

  1. get_schema_for — look up the exact shape of the concept you need (layer item, control, style, view). Always consult the schema first.
  2. get_examples — find the closest real config to adapt from.
  3. Draft a config combining schema knowledge with the example.
  4. validate_config — fix any errors, repeat until valid.
  5. search_dmp_catalogue — look up DMP layer URNs when adding DMP layers.
  6. inspect_service — discover layers on a WFS/WMS service before authoring a config.
  7. inspect_features_host — inspect a WFS URL to get field names before writing template_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/:

BinaryPurpose
septima-widget-mcpMCP server (stdio transport)
build_dbRecompute 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; use tracing (→ stderr).
  • Schema gap: map and data are 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.
Ver o original no GitHub

Bom para

Relacionados