convez.ai
MCP ServerAutomaçãoIntermediário
kfezer

Vestaboard MCP

kfezer/vestaboard-mcp

Controle painéis Vestaboard com agentes de IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que controla um painel Vestaboard (display split-flap) via API Local, permitindo enviar texto, gráficos e layouts ricos. Inclui helper para codificar texto e construir layouts como painéis de clima com ícones coloridos.

Instalação

$npx convez-ai kfezer/vestaboard-mcp

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
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Exibir informações dinâmicas em painéis físicos (clima, horários, notícias)
  • Automação de displays corporativos e residenciais
  • Criar dashboards visuais com cores e símbolos em tempo real

Veredito

MCP bem estruturado e funcional para integrar painéis Vestaboard em fluxos de IA. Requer setup de rede local e API key, mas oferece controle robusto sobre displays físicos com recursos de layout e cor.

README

A tradução para o português deste README ainda está na fila.

Vestaboard MCP

A small MCP (Model Context Protocol) server for controlling a Vestaboard split-flap display over its Local API, plus a helper for building rich text/graphic layouts (e.g. a daily weather board).

It exposes simple tools an LLM agent (Claude, Hermes, etc.) can call to read, write, clear, and draw on the board.

Features

  • vestaboard_send_text — send centered multi-line text (auto-laid out into the 6×22 grid).
  • vestaboard_send_raw — send a raw 6×22 grid of character codes (full control over letters, digits, punctuation, and color chips).
  • vestaboard_read — read the board's current contents (returns a decoded text approximation).
  • vestaboard_clear — blank the board.
  • vesta_encode.py — standalone helper that converts text → correct Vestaboard character codes and builds a weather layout with a little color "icon" (sun / cloud / rain / snow / storm). Use it directly or from a scheduled job.

Requirements

  • A Vestaboard with the Local API enabled and an Local API key. See Vestaboard's Local API docs.
  • Python 3.10+
  • The board reachable on your network (host + port).

Install

git clone https://github.com/kfezer/vestaboard-mcp.git
cd vestaboard-mcp
pip install -r requirements.txt

Configuration

Copy the example env file and fill in your board's host and Local API key:

cp .env.example .env
# .env
VESTABOARD_HOST=http://192.168.x.x:7000     # your board's local IP + port
VESTABOARD_API_KEY=your_local_api_key_here

The server reads these from the environment (VESTABOARD_HOST, VESTABOARD_API_KEY).

Running

As a standalone MCP server (stdio)

python3 vestaboard_mcp.py

Registering with an MCP host

Add it to your MCP host's server config. Example (mcp_servers block, as used by Hermes / Claude-style configs):

mcp_servers:
  vestaboard:
    command: python3
    args:
      - /absolute/path/to/vestaboard-mcp/vestaboard_mcp.py
    env:
      VESTABOARD_HOST: http://192.168.x.x:7000
      VESTABOARD_API_KEY: your_local_api_key_here
    enabled: true

Or the Claude Desktop style (claude_desktop_config.json):

{
  "mcpServers": {
    "vestaboard": {
      "command": "python3",
      "args": ["/absolute/path/to/vestaboard-mcp/vestaboard_mcp.py"],
      "env": {
        "VESTABOARD_HOST": "http://192.168.x.x:7000",
        "VESTABOARD_API_KEY": "your_local_api_key_here"
      }
    }
  }
}

Character codes

The board is a 6 rows × 22 columns grid. Each cell is an integer character code.

Code(s)Meaning
0Blank
1–26A–Z
27–351–9
360
37–60Punctuation (!@#$()-+&=;:'"%,./?)
62° (degree)
63–70Color chips: 63 red, 64 orange, 65 yellow, 66 green, 67 blue, 68 violet, 69 white, 70 black
71Filled (all-on)

Note: digits are 1–9 = 27–35 and 0 = 36 (zero comes after nine), and the degree symbol is 62. These match the official Vestaboard character codes. Using the wrong table makes digits render as punctuation.

The vesta_encode.py helper already encodes against this verified table, so prefer it over hand-building grids.

Weather board helper

vesta_encode.py builds a ready-to-send 6×22 grid for a weather display, including a small color "icon" chosen from the condition text.

python3 vesta_encode.py --now 57 --hi 67 --lo 48 --condition "Light Rain" --preview

--preview prints an ASCII rendering to stderr:

|   SEATTLE WEATHER    |
|                      |
|  NOW 57°F    WWWW    |
|  LIGHT RAIN  B B B   |
| HI 67°  LOW 48°      |
|BBBBBBBBBBBBBBBBBBBBBB|

The JSON 6×22 grid is printed to stdout — pipe it straight into vestaboard_send_raw.

Icons by condition

Condition keywordsIconStrip color
sunny / clear / sunyellow blockyellow
rain / drizzle / showerwhite cloud + blue dropsblue
cloudy / overcastwhite cloudwhite
snow / sleet / blizzardwhite cloud + white flakeswhite
thunder / storm / lightningwhite cloud + violet boltviolet
fog / mist / hazewhite blockwhite

Example: daily weather cron

Fetch the forecast and push it to the board on a schedule (e.g. weekday mornings):

# 7:30am Mon–Fri
30 7 * * 1-5  /path/to/update_weather.sh
#!/bin/bash
# update_weather.sh — fetch Seattle weather and draw it on the board
cd "$(dirname "$0")"
read NOW HI LO COND < <(curl -s 'https://wttr.in/Seattle?format=j1' | python3 -c '
import sys, json
d = json.load(sys.stdin)
c = d["current_condition"][0]; t = d["weather"][0]
print(c["temp_F"], t["maxtempF"], t["mintempF"], c["weatherDesc"][0]["value"])
')
GRID=$(python3 vesta_encode.py --now "$NOW" --hi "$HI" --lo "$LO" --condition "$COND")
curl -s -X POST "$VESTABOARD_HOST/local-api/message" \
  -H "X-Vestaboard-Local-Api-Key: $VESTABOARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$GRID"

API notes

  • Messages are sent via POST {VESTABOARD_HOST}/local-api/message with header X-Vestaboard-Local-Api-Key.
  • The current board is read via GET {VESTABOARD_HOST}/local-api/message.
  • vestaboard_read's decode is a best-effort text approximation; for exact verification, judge by what's physically on the board.

License

MIT

Ver o original no GitHub

Bom para

Relacionados