gijon-avisos-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gijon-avisos-mcp Tengo una foto de una farola fundida, crea el aviso por mí"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gijon-avisos-mcp
Servidor MCP (y CLI de apoyo) para el sistema de avisos del Ayuntamiento de Gijón (CuidaGijón). Permite a un agente listar tipos de incidencia y crear avisos con inteligencia artificial — incluso desde una foto. Sin autenticación: el servicio municipal no pide credenciales.
La finalidad de este proyecto es hacer más fácil que los ciudadanos puedan reportar problemas al Ayuntamiento de Gijón. Saca una foto de la incidencia (una farola fundida, una baldosa rota, un semáforo apagado…), pásasela al agente pidiéndole que genere un aviso para que describa el problema, seleccione el tipo, añada la ubicación y lance el aviso al Ayuntamiento.
Inicio rápido
Gijón no usa credenciales: el SOAP municipal acepta llamadas directas y cada aviso lleva el email del comunicante.
Añade el servidor a tu cliente MCP (ejemplos) o configúralo a mano:
{
"mcpServers": {
"gijon-avisos": {
"command": "npx",
"args": ["-y", "gijon-avisos-mcp"]
}
}
}Verifica:
list_categoriesdebe devolver los 5 tipos (ALU, VIA, SEM, SEN, VER).Pregunta al humano UNA vez su email y guárdalo con la tool
set_identity. Se reutiliza en todos los avisos.Flujo del agente:
create_aviso_from_photo(foto → tipo → preview) → enseña el preview al humano →confirm: true+human_confirmed: true+preview_tokensolo con su "sí".
Todo corre en tu máquina; los avisos se crean con el email guardado.
Related MCP server: laspalmas-avisos-mcp
Fotos demasiado grandes para el modelo
Algunos modelos rechazan fotos muy grandes (image decode limit exceeded). El servidor
reduce en TypeScript (sin dependencias) conservando el GPS, así que el modelo nunca
necesita procesar la original:
Remoto (HTTP): sube la foto con curl y usa el
file_id(los bytes no pasan por el modelo). Requiere el secreto del servidor:curl -X PUT --data-binary @foto.jpg \ -H "Authorization: Bearer ***" \ 'http://127.0.0.1:3002/upload?filename=foto.jpg' # → {"file_id":"…","bytes":…}El preview devuelve
preview_image_base64(copia reducida) para visión y el envío usa siempre la original como data URL.Local (stdio/CLI): pasa
image_path; el servidor lee y reduce sin que el modelo abra el fichero. O reduce tú connode dist/cli.js prep-photo foto.jpg [foto-ligera.jpg].
¿Eres un agente IA? Lee esto primero
La skill (skill/SKILL.md) no se autoinstala: cópiala al directorio de tu cliente
y abre sesión nueva.
cp -r skill ~/.hermes/skills/gijon-avisos # Hermes
cp -r skill ~/.claude/skills/gijon-avisos # Claude Code
# o descárgala: https://github.com/Naroh091/gijon-avisos-mcp/blob/main/skill/SKILL.mdInstálalo así (requiere Node 18+):
Sin credenciales: este MCP no necesita tokens ni cuentas. Solo el email del humano (paso 3 del inicio rápido).
Instalación según tu cliente (comandos exactos): Claude Code (
claude mcp add … -- npx -y gijon-avisos-mcp), Hermes (hermes mcp add … --command npx … --args -y gijon-avisos-mcp) u OpenClaw (openclaw mcp add … --command npx --arg -y --arg gijon-avisos-mcp).Identidad: pregunta el email UNA vez y guárdalo con
set_identity(verifica conget_identity).Verifica (
mcp list/test/doctor --probesegún cliente): debes ver 7 tools.Uso: hay skill completa en
skill/SKILL.md. Lo esencial: solo incidencias genuinas;create_aviso_from_photoen fases (tipo → preview → envío solo con "sí" humano +confirm+human_confirmed+preview_token); foto porfile_id; la dirección es texto libre y las coordenadas van en el aviso.
Añadir el MCP vía npx
Requiere Node 18+.
Claude Code
claude mcp add gijon-avisos -- npx -y gijon-avisos-mcp
claude mcp list # verificarHermes
hermes mcp add gijon-avisos --command npx --args -y gijon-avisos-mcp
hermes mcp test gijon-avisos # verificar (lista las 7 tools)OpenClaw
openclaw mcp add gijon-avisos \
--command npx \
--arg -y \
--arg gijon-avisos-mcp \
openclaw mcp doctor gijon-avisos --probe # verificarDesde código
npm install
npm run build
npx -y -p gijon-avisos-mcp gijon-avisos-mcp-http # HTTP en 127.0.0.1:3002/mcpHerramientas MCP
Tool | Qué hace |
| Email guardado del comunicante (o null). |
| Guarda el email (se pregunta una vez). |
| Tipos de incidencia: ALU, VIA, SEM, SEN, VER. |
| Detalle de un tipo (código y nombre). |
| Sugiere tipos por palabras. |
| Crea un aviso. Dry-run por defecto; |
| Aviso desde foto en fases: tipo → preview (GPS EXIF) y envío solo con |
Seguridad de envío
create_aviso es dry-run por defecto: devuelve los campos sin crear nada. Solo con
confirm: true hace el SOAP real — un aviso real que revisa personal municipal.
Envía únicamente incidencias reales.
create_aviso_from_photo exige confirmación humana en fases:
Tipo (sin
tipo): sugiere y no envía nada.Preview (
confirmausente/false): GPS EXIF (olat/lonmanuales), dirección en texto libre, payload +preview_token. No envía nada.Envío: el agente muestra el preview al humano y espera su "sí"; solo entonces repite la llamada con los MISMOS campos +
confirm: true+human_confirmed: true+preview_token. Si cambió cualquier campo, hay que repetir el preview.
Tipos de incidencia
ALU — Alumbrado (farolas fundidas o rotas).
VIA — Conservación viaria (baches, baldosas, bordillos).
SEM — Red Semafórica (semáforos apagados o averiados).
SEN — Señalización Viaria (señales caídas o que faltan).
VER — Zonas verdes (arbolado, jardines).
Uso como CLI
node dist/cli.js categories
node dist/cli.js identity-set nombre@example.com es
node dist/cli.js create VIA 43.5322 -5.6611 "Calle Corrida 1" -- "Baldosa rota" # dry-run
node dist/cli.js create VIA 43.5322 -5.6611 "Calle Corrida 1" -- "Baldosa rota" --send # ENVÍA de verdad
node dist/cli.js from-photo foto.jpg VIA "Baldosa rota" # preview desde foto
node dist/cli.js prep-photo foto.jpg [foto-ligera.jpg] # reduce para el modelo, conserva EXIF/GPSServidor HTTP (opcional)
Por stdio cada uno corre su copia. La entrada HTTP sirve para exponer el servidor que corre en TU máquina para que un agente en OTRA máquina lo use.
export GIJON_AVISOS_MCP_SECRET=<un-secreto-largo> # exige x-mcp-secret o Bearer
export GIJON_AVISOS_ALLOWED_HOSTS=tu-host.tu-tailnet.ts.net # anti DNS-rebinding
npm run start:http # 127.0.0.1:3002/mcpVariables: GIJON_AVISOS_HTTP_PORT (3002), GIJON_AVISOS_HTTP_HOST (127.0.0.1),
GIJON_AVISOS_HTTP_PATH (/mcp). Expón solo en red privada (p.ej. tailscale serve,
nunca funnel). Para persistencia, launchd/pm2/tmux o similar.
Arquitectura
src/client.ts— SOAP mínimo (GetTipos/InsertIncidenciaSmartphone), sin auth.src/identity.ts— email en JSON local (0600).src/avisos.ts— núcleo de negocio (reutilizado por MCP y CLI).src/photo.ts— foto: EXIF/GPS, subida a tmp, token de preview.src/types.ts— esquemas zod de entrada + campos de creación.src/mcp.ts—buildServer(): registra las 7 tools (compartido por stdio y HTTP).src/server.ts— entrada stdio ·src/http.ts— entrada HTTP (/mcp+PUT /upload) ·src/cli.ts— CLI.
Notas
Ingeniería inversa del APK "CuidaGijón" v2.5.1 + verificación en vivo de tipos y dry-runs (sin crear avisos reales).
Licencia
AGPLv3. Ver LICENSE.
Available Tools
7 toolscreate_avisoA
Crea un aviso. IMPORTANTE: por defecto es DRY-RUN (confirm=false) y solo devuelve los campos que se enviarían, SIN crear nada. Para crear de verdad hay que pasar confirm=true. Usa el email guardado salvo 'identity'.
Inputs: lat (required), lon (required), tipo (required), address (required), +4 more.
create_aviso_from_photoA
Aviso desde una FOTO en fases. VÍA PREFERIDA: sube la foto con PUT /upload (curl) y pasa file_id; por stdio usa image_path local. Sin tipo → sugiere (need_category). Con todo → preview + preview_token SIN enviar. Envío: MISMOS campos + confirm:true + human_confirmed:true + preview_token (tras 'sí' humano). Sin las tres NO se envía. La foto viaja en el mismo envío (data URL).
Inputs: lat, lon, tipo, address, +9 more.
get_categoryC
Detalle de un tipo (código y nombre).
Inputs: code (required), lang.
get_identityA
Devuelve la identidad guardada (email, idioma) o null si aún no se preguntó.
Inputs: no named parameters.
list_categoriesB
Tipos de incidencia (ALU, VIA, SEM, SEN, VER). Sin auth.
Inputs: lang.
set_identityB
Guarda el email del comunicante (se pregunta UNA vez y se reutiliza; es la identidad del aviso).
Inputs: lang (required), userEmail (required).
suggest_categoriesC
Sugiere tipos por palabras (p.ej. 'farola apagada').
Inputs: hint.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Identity (get/set), category (list/get/suggest), and creation (aviso/photo) tools are largely distinct. Minor overlap exists between create_aviso and create_aviso_from_photo (both create reports, differentiated only by photo input) and between list_categories and suggest_categories (both surface types, one filtered).
All seven tools follow a consistent snake_case verb_noun pattern (get_identity, set_identity, list_categories, get_category, suggest_categories, create_aviso, create_aviso_from_photo). No mixing of conventions or vague verbs.
Seven tools is well-scoped for a municipal incident-reporting client, with each tool earning its place (identity, category lookup, and two creation paths). No redundancy or filler.
The surface covers identity, category discovery, and report creation (text and photo), but offers no way to list, get, or track previously submitted avisos, nor to update/withdraw them. This creates a dead end for verifying report status, a notable gap for a reporting domain.
Maintenance
Related MCP Connectors
Mobility, geocoding and nearby urban services for AI agents.
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables incident management through natural language, with tools for searching, retrieving, creating, updating, and commenting on issues, simulating upstream events, creating GitHub issues, and listing side effects.101MIT
- AlicenseBqualityCmaintenanceEnables an AI agent to list municipal services and categories, query existing reports, and create new reports to the Las Palmas de Gran Canaria city council—including from a photo—with human confirmation before submission.816 npm3AGPL 3.0
- AlicenseBqualityCmaintenanceEnables AI agents to report street incidents to Valencia City Council by listing categories, geocoding streets, checking existing reports, and creating nuevos avisos from text or photos with human-confirmed previews. Supports stdio and HTTP transports, with identity and device registration handled locally.1116 npm1AGPL 3.0
- AlicenseBqualityCmaintenanceEnables AI agents to report incidents to the Bilbao City Council (MeJora Bilbao / Bilbo Hobetuz) by listing categories, looking up streets, reviewing existing reports, and creating new ones — including generating a report directly from a geolocated photo. Drafts are dry-run by default and real submissions require explicit human confirmation.1216 npm1AGPL 3.0