MCP Server Poncho

MCP Server Poncho

  

Servidor MCP (Model Context Protocol) para la librería Poncho del Gobierno Argentino - el sistema de diseño de argentina.gob.ar.

¿Qué es Poncho?

Poncho es el sistema de diseño del Gobierno Argentino que proporciona componentes, estilos y patrones para crear sitios web institucionales consistentes con la identidad visual de argentina.gob.ar.

¿Qué hace este MCP?

Este servidor MCP permite a los asistentes de IA (Claude, Cursor, etc.) acceder a:

• Documentación completa de todos los componentes Poncho
• Búsqueda por keywords de componentes y plantillas (nombre, descripción, palabras clave)
• Generación de código HTML/JS para tablas, mapas, calendarios y más
• Plantillas listas para usar de páginas completas (home, login, formularios, etc.)
• Utilidades como paleta de colores, códigos de provincias y feriados
• Guías de integración con Angular, React, Vue y Next.js
• Resources (URIs poncho://) y Prompts guiados para adaptar plantillas e insertar componentes

Características

• 25+ tools organizados en categorías
• Búsqueda por keywords de componentes y plantillas (nombre, descripción, palabras clave)
• Plantillas HTML completas del sistema de diseño argentino
• Generación de código para PonchoTable, PonchoMap y más
• Soporte para frameworks modernos (Angular 17+, React 18+)
• Recursos MCP (Resources) y prompts guiados (adaptar plantilla, insertar componente)

Requisitos

• Java 21+ instalado (OpenJDK u otra distribución compatible)

Uso rápido (3 pasos)

Paso 1: Descargar el JAR

1. Abrí la página de releases de GitHub del proyecto: https://github.com/idemfede/mcp-server-poncho/releases/latest.
2. Descargá el archivo mcp-server-poncho-*.jar (el JAR más reciente).
3. Guardalo en una carpeta fácil de recordar, por ejemplo: /home/tu-usuario/apps/poncho/.

Paso 2: Configurar el MCP o ejecutarlo a mano

• Opción A – Ejecutarlo a mano

En una terminal, ejecutá:

  java -jar /ruta/al/archivo/mcp-server-poncho-1.0.0.jar

(Reemplazá /ruta/al/archivo/ por la ruta donde guardaste el JAR).

• Opción B – Configurarlo en tu IDE

- En Cursor, agregá el servidor en tu configuración MCP (ver sección "Configuración en Cursor" más abajo). - En Claude Desktop, agregalo en claude_desktop_config.json (ver sección "Configuración en Claude Desktop").

El servidor se iniciará en http://localhost:8081 por defecto.

Paso 3: Probar en el chat

Una vez que el servidor esté corriendo y configurado:

• Probá en el chat algo como:

- *"Creame una página de login usando Poncho"* - *"Mostrame los colores institucionales de Poncho"*

Configuración en Cursor

Agrega el siguiente bloque a tu configuración de MCP en Cursor (~/.cursor/mcp.json o la configuración del workspace):

{
  "mcpServers": {
    "argendata-poncho": {
      "command": "java",
      "args": ["-jar", "/ruta/a/mcp-server-poncho-1.0.0.jar"]
    }
  }
}

El servidor también expone un endpoint HTTP SSE en http://localhost:8081/sse, pero la integración recomendada con Cursor es mediante stdio usando command y args.

Configuración en Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "argendata-poncho": {
      "command": "java",
      "args": ["-jar", "/ruta/a/mcp-server-poncho-1.0.0.jar"]
    }
  }
}

Tools Disponibles

Documentación

Generadores de Código

Plantillas de Páginas

Utilidades

Integración con Frameworks

Prompts

Prompts guiados que devuelven instrucciones para el modelo (system + user message):

Resources (URIs)

Recursos de solo lectura vía protocolo MCP. Se accede con read_resource o equivalente del cliente.

Categorías y plantillas

Componentes y dependencias

Ejemplo de Uso

Una vez configurado, puedes pedirle al asistente:

• *"Creame una página de login usando Poncho"*
• *"Generá una tabla con filtros para mostrar datos de un Google Sheet"*
• *"¿Cómo integro PonchoMap en mi proyecto Angular?"*
• *"Mostrame los colores institucionales del sistema Poncho"*
• *"Necesito un mapa de Argentina con las provincias del NOA coloreadas"*

Desarrollo

Ejecutar tests

mvn test

Verificación completa (tests + cobertura + Checkstyle + SpotBugs + Dependency-Check)

mvn verify

Reportes: target/site/jacoco/index.html (cobertura), Checkstyle y SpotBugs en consola. Para omitir el scan de CVEs en local: mvn verify -DskipDependencyCheck=true.

Ejecutar en modo desarrollo

mvn spring-boot:run

Estructura del proyecto

src/main/java/com/argendata/mcp/poncho/
├── PonchoMcpApplication.java    # Punto de entrada
├── config/                      # Configuración Spring
├── model/                       # Records y DTOs
├── service/                     # Lógica de negocio
└── tools/                       # Tools MCP
    ├── PonchoDocsTools.java     # Documentación
    ├── PonchoGeneratorTools.java # Generación de código
    ├── PonchoTemplateTools.java  # Plantillas
    ├── PonchoUtilsTools.java     # Utilidades
    └── PonchoFrameworkTools.java # Integración frameworks

Contribuir

Ver CONTRIBUTING.md para guías de contribución.

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0 - ver el archivo LICENSE para más detalles.

Links

• Poncho - Sistema de Diseño
• argentina.gob.ar
• MCP Protocol
• Spring AI MCP