AyA-MCP v0.2

Núcleo MCP determinista universal de AYA / De Bruin Sistemas.

La v0.2 amplía el proyecto a todas las áreas de la empresa: sistemas web, APIs, SaaS, ecommerce, sitios, mobile/desktop, games, IA, fiscal Brasil, pagos, comunicación, datos, seguridad, automatización e infraestructura.

Línea pre-1.0. El package.json usa 0.2.0 por SemVer/npm; la versión pública es v0.2.

Objetivo

Reducir cuánto necesita una LLM recordar, interpretar e improvisar. Siempre que una regla importante pueda convertirse en código, gate, tool, resource, schema, evidence o policy, AyA-MCP debe preferir eso a una instrucción textual suelta.

Related MCP server: mcp-tool-server

Integración con el paquete Agents

El paquete privado Agentes de IA es una fuente funcional de la v0.2. Configure:

AYA_FRAMEWORK_AGENTS_ROOT=/caminho/Agentes-de-IA

El MCP cataloga y enruta runtimes, agentes, skills, packs especializados, templates y vendor skills sin cargar miles de archivos en el contexto.

El contenido propietario de Agents no se copia a este repositorio público.

Reglas de Agents transformadas en comportamiento

• copia de seguridad antes de editar -> aya_arquivo_escrever_seguro;

• log inmediato -> aya_execucao_log_registrar;

• UTF-8 sin BOM -> aya_arquivo_encoding_validar;

• continuidad -> aya_memoria_agents_inicializar + checkpoint/handoff;

• evidencia antes de listo -> aya_evidencia_*;

• dos fallos iguales -> aya_loop_falha_registrar genera bloqueo;

• enrutamiento/skills/packs -> aya_framework_*;

• gobernanza del framework -> aya_framework_governanca_auditar;

• template-first -> aya_template_primeiro_planejar;

• privacidad de modelo -> aya_modelo_privacidade_avaliar;

• LLM débil -> aya_modelo_perfil_execucao + toolsets/contexto selectivo.

Games

Games es un dominio de primera clase.

Motores detectados inicialmente:

• Godot;

• Unity;

• Unreal Engine;

• Phaser;

• Three.js/WebGL;

• Flutter/Flame;

• libGDX;

• GameMaker;

• Defold;

• Ren'Py;

• LÖVE2D.

Herramientas:

• aya_games_detectar_engine;

• aya_games_assets_inventariar;

• aya_games_validar;

• aya_games_checklist.

La capa de Games se ampliará aún en la v0.2 con integraciones especializadas cuando estén disponibles.

Memoria persistente

La v0.2 combina dos modelos:

1. memoria operacional/checkpoint/handoff para continuidad entre LLMs;

2. memoria en grafo del proyecto, inspirada en el servidor Memory MCP.

Recurso:

aya://projeto/memoria-grafo

Herramientas:

• aya_memoria_grafo_ler;

• aya_memoria_grafo_buscar;

• aya_memoria_grafo_abrir;

• aya_memoria_grafo_upsert;

• aya_memoria_grafo_observar;

• aya_memoria_grafo_relacionar;

• aya_memoria_grafo_remover.

Los secretos se sanitizan antes de persistir observaciones.

Código y economía de contexto

Inspirado en Serena y mcp-language-server, AyA-MCP ha ganado una capa nativa ligera:

• aya_codigo_outline;

• aya_codigo_referencias;

• aya_codigo_editar_linhas;

• aya_codigo_semantico_planejar.

El outline/referencias nativos son deliberadamente léxicos. Para definition/rename/diagnostics/call hierarchy semánticamente correctos, preferir LSP/Serena aprobado. AyA-MCP no invoca regex de LSP.

Toolsets

Por defecto todas las capacidades están registradas:

AYA_TOOLSETS=all

Para una LLM más pequeña, reduzca los schemas:

AYA_TOOLSETS=games,codigo,arquivos,memoria,seguranca,evidencias,equipe,agents

Toolsets disponibles:

• specforge;

• agents;

• games;

• codigo;

• arquivos;

• memoria;

• seguranca;

• mcps;

• evidencias;

• templates;

• equipe.

Use aya_toolsets_sugerir para montar un conjunto mínimo por tarea.

MCPs externos investigados

La v0.2 estudió proyectos abiertos para absorber buenas prácticas:

• modelcontextprotocol/servers;

• github/github-mcp-server;

• docker/mcp-gateway;

• oraios/serena;

• isaacphi/mcp-language-server;

• microsoft/playwright-mcp;

• ChromeDevTools/chrome-devtools-mcp;

• googleapis/mcp-toolbox;

• crystaldba/postgres-mcp;

• upstash/context7;

• wonderwhy-er/DesktopCommanderMCP.

Detalles en docs/MCPs-ABERTOS-APROVEITADOS-v0.2.md y config/mcps-abertos-pesquisados-v0.2.json.

AyA no instala MCP desconocido automáticamente.

Seguridad

• workspace fijado en AYA_WORKSPACE_ROOT;

• solo lectura por defecto;

• la escritura exige AYA_MODO_ESCRITA=true;

• path traversal bloqueado;

• los symlinks del framework no escapan de la raíz autorizada;

• .git, node_modules, vendor y vendor skills protegidos contra escritura genérica;

• copia de seguridad antes de edición;

• SHA-256 como precondición opcional/obligatoria en las ediciones quirúrgicas;

• logs/auditoría sanitizan secretos;

• la auditoría estática busca secretos hardcoded, shell peligrosa, eval, TLS inseguro, CORS y lockfiles;

• el contenido externo se trata como dato no fiable;

• ninguna shell irrestricta en la v0.2.

Equipo multiagente universal

aya_agentes_planejar_equipe monta los roles según el proyecto. Además de Orquestador, Analista, Arquitecto, Ejecutor, Revisor, Tester, Continuidad y Crítico, puede añadir especialistas en:

• datos;

• backend;

• frontend;

• mobile;

• game design;

• engine/performance;

• seguridad;

• DevOps;

• fiscal Brasil;

• pagos;

• comunicación;

• IA/LLM;

• evidencia/consentimiento.

SpecForge

SpecForge sigue siendo un consumidor privilegiado de AyA-MCP, pero el MCP no depende de él para existir.

Las herramientas REQ/RN/CT/T, trazabilidad, cola, calidad, agentes y aya_validacao_aprovar_saida quedan en el toolset specforge.

Ejecución local

npm install
npm run build
AYA_WORKSPACE_ROOT=/caminho/do/projeto npm start

Con Agents:

AYA_WORKSPACE_ROOT=/caminho/do/projeto \
AYA_FRAMEWORK_AGENTS_ROOT=/caminho/Agentes-de-IA \
npm start

VPS / remoto

npm run start:http

Fuera de loopback, configure token y host allowlist según .env.exemplo.

Calidad

npm run verificar

GitHub Actions ejecuta el build de TypeScript y las pruebas en cada push/PR.

Documentos principales

• docs/V0.2-ESCOPO.md

• docs/INTEGRACAO-AGENTS.md

• docs/GAMES.md

• docs/MCPs-ABERTOS-APROVEITADOS-v0.2.md

• docs/SEGURANCA.md

• docs/ROADMAP.md

• CHANGELOG.md

• VERSIONAMENTO.md