mcp-directorio-acambaro

Roadmap y checklist

En una línea: los pasos, en orden, para pasar de repo vacío a MCP desplegado y presentable en el portafolio.

Fase 0 — Preparación (1 día)

• Crear repo público atapia9/mcp-directorio-acambaro (MIT, .gitignore Node)
• Instalar Node 20+, Claude Desktop y Claude Code (nota: desde la Fase 5, better-sqlite3/vitest requieren Node 22.12+)
• Copiar estos .md a docs/ y CLAUDE.md a la raíz
• Leer la documentación oficial: modelcontextprotocol.io (quickstart servidor TS) — objetivo técnico cumplido: la implementación (Fases 1–5) sigue el SDK oficial (@modelcontextprotocol/sdk) verificado contra sus tipos y probado en MCP Inspector

Fase 1 — Esqueleto (1 día)

• npm init, TypeScript, ESLint, Prettier, vitest
• src/index.ts con McpServer + StdioServerTransport
• Tool de prueba ping y verificación en MCP Inspector
• Commit: feat: esqueleto del servidor MCP

Fase 2 — Dominio y datos (2 días)

• negocios.json con 15–30 negocios ficticios en 6+ categorías
• domain/horario.ts (abierto ahora, zona horaria MX) + pruebas
• domain/busqueda.ts (texto, categoría, colonia, sin acentos) + pruebas
• domain/diagnostico.ts (puntaje de presencia digital) + pruebas

Fase 3 — Capacidades MCP (2 días)

• Tools: buscar_negocios, detalle_negocio, negocios_abiertos, diagnostico_digital
• Resources: directorio://categorias, sdda://servicios
• Prompts: recomendar_negocio, propuesta_sdda
• Probar cada capacidad en MCP Inspector
• Conectar en Claude Desktop y probar 5 preguntas reales — conectado desde Settings/Conectores de la app (edición manual de claude_desktop_config.json no sirve, la app la sobrescribe); verificado que Claude.app levantó node dist/index.js como subproceso y respondió correctamente a preguntas reales

Fase 4 — Calidad y CI (1 día)

• GitHub Actions: lint + test + build en cada push/PR
• Cobertura ≥ 80 % en domain/
• Manejo de errores claro (id inexistente, parámetros inválidos)
• Tag v0.1.0 y release

Fase 5 — Persistencia y despliegue (3 días)

• Migrar repositorio a SQLite (misma interfaz)
• src/http.ts con Streamable HTTP
• Desplegar en instancia OCI A1 (systemd o Docker) tras Cloudflare, HTTPS — preparado y validado localmente (simulación de “modo producción” con solo dependencias de producción, deploy/cloudflared-config.example.yml, deploy/verificar.sh); falta ejecutarlo en la instancia real, pendiente de acceso SSH/Cloudflare
• Token simple por header para limitar acceso
• Tag v0.2.0

Fase 6 — Integración y vitrina (2 días)

• (Opcional) Sincronizar con WordPress REST de staging.acambaro.com.mx
• README final: badges, GIF demo, diagrama, instalación en 5 min — hecho salvo el GIF (badges, diagrama, instalación y sección “Ejemplo de uso” con salida real ya están); el GIF se graba una vez desplegado
• Publicar en LinkedIn + fijar repo en perfil GitHub
• (Opcional) Registrar en listados públicos de servidores MCP — server.json ya preparado (ver docs/03-DESPLIEGUE.md); falta correr mcp-publisher publish tras el despliegue
• Tag v1.0.0

Estimado total

≈ 12 días de trabajo (2–3 semanas a ritmo parcial).

This site is open source. Improve this page.