AyA-MCP v0.2

Универсальное детерминированное ядро MCP компании AYA / De Bruin Sistemas.

v0.2 расширяет проект на все области компании: веб-системы, API, SaaS, электронную коммерцию, сайты, мобильные/десктопные приложения, игры, ИИ, налоговую сферу Бразилии, платежи, коммуникации, данные, безопасность, автоматизацию и инфраструктуру.

Линия pre-1.0. В package.json используется 0.2.0 по SemVer/npm; публичная версия — v0.2.

Цель

Сократить объём того, что LLM должна запоминать, интерпретировать и импровизировать. Всякий раз, когда важное правило можно превратить в код, шлюз, инструмент, ресурс, схему, доказательство или политику, AyA-MCP должен предпочитать это разрозненной текстовой инструкции.

Related MCP server: mcp-tool-server

Интеграция с пакетом Agents

Приватный пакет Agentes de IA — функциональный источник v0.2. Настройте:

AYA_FRAMEWORK_AGENTS_ROOT=/caminho/Agentes-de-IA

MCP инвентаризирует и маршрутизирует рантаймы, агентов, скиллы, специализированные пакеты, шаблоны и вендорские скиллы, не загружая тысячи файлов в контекст.

Собственный контент Agents не копируется в этот публичный репозиторий.

Правила Agents, преобразованные в поведение

• резервное копирование перед редактированием -> aya_arquivo_escrever_seguro;

• немедленное логирование -> aya_execucao_log_registrar;

• UTF-8 без BOM -> aya_arquivo_encoding_validar;

• непрерывность -> aya_memoria_agents_inicializar + checkpoint/handoff;

• доказательства перед готовностью -> aya_evidencia_*;

• два одинаковых сбоя -> aya_loop_falha_registrar создаёт блокировку;

• маршрутизация/скиллы/пакеты -> aya_framework_*;

• управление фреймворком -> aya_framework_governanca_auditar;

• template-first -> aya_template_primeiro_planejar;

• конфиденциальность модели -> aya_modelo_privacidade_avaliar;

• слабая LLM -> aya_modelo_perfil_execucao + выборочные наборы инструментов/контекст.

Игры

Игры — домен первого класса.

Первоначально определяемые движки:

• Godot;

• Unity;

• Unreal Engine;

• Phaser;

• Three.js/WebGL;

• Flutter/Flame;

• libGDX;

• GameMaker;

• Defold;

• Ren'Py;

• LÖVE2D.

Инструменты:

• aya_games_detectar_engine;

• aya_games_assets_inventariar;

• aya_games_validar;

• aya_games_checklist.

Слой Игр будет расширен уже в v0.2 специализированными интеграциями, когда они станут доступны.

Постоянная память

v0.2 сочетает две модели:

1. рабочая память/checkpoint/handoff для непрерывности между LLM;

2. графовая память проекта, вдохновлённая сервером Memory MCP.

Ресурс:

aya://projeto/memoria-grafo

Инструменты:

• 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.

Секреты санируются перед сохранением наблюдений.

Код и экономия контекста

Вдохновлённый Serena и mcp-language-server, AyA-MCP получил лёгкий нативный слой:

• aya_codigo_outline;

• aya_codigo_referencias;

• aya_codigo_editar_linhas;

• aya_codigo_semantico_planejar.

Нативные outline/ссылки намеренно лексические. Для семантически корректных определений/переименований/диагностики/иерархии вызовов предпочитайте одобренный LSP/Serena. AyA-MCP не вызывает regex из LSP.

Наборы инструментов

По умолчанию регистрируются все возможности:

AYA_TOOLSETS=all

Для менее мощной LLM сократите схемы:

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

Доступные наборы инструментов:

• specforge;

• agents;

• games;

• codigo;

• arquivos;

• memoria;

• seguranca;

• mcps;

• evidencias;

• templates;

• equipe.

Используйте aya_toolsets_sugerir, чтобы собрать минимальный набор для каждой задачи.

Исследованные внешние MCP

v0.2 изучила открытые проекты, чтобы перенять лучшие практики:

• 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.

Подробности в docs/MCPs-ABERTOS-APROVEITADOS-v0.2.md и config/mcps-abertos-pesquisados-v0.2.json.

AyA не устанавливает неизвестный MCP автоматически.

Безопасность

• рабочая область зафиксирована в AYA_WORKSPACE_ROOT;

• по умолчанию только чтение;

• запись требует AYA_MODO_ESCRITA=true;

• path traversal заблокирован;

• симлинки фреймворка не выходят за пределы авторизованного корня;

• .git, node_modules, vendor и vendor skills защищены от общей записи;

• резервное копирование перед редактированием;

• SHA-256 как опциональное/обязательное предусловие при точечных правках;

• логи/аудит санируют секреты;

• статический аудит ищет захардкоженные секреты, опасный shell, eval, небезопасный TLS, CORS и lockfiles;

• внешний контент рассматривается как ненадёжные данные;

• в v0.2 нет неограниченной shell.

Универсальная мультиагентная команда

aya_agentes_planejar_equipe формирует роли в соответствии с проектом. Помимо Оркестратора, Аналитика, Архитектора, Исполнителя, Ревьюера, Тестировщика, Непрерывности и Критика, может добавлять специалистов по:

• данным;

• бэкенду;

• фронтенду;

• мобильным приложениям;

• геймдизайну;

• движкам/производительности;

• безопасности;

• DevOps;

• налоговой сфере Бразилии;

• платежам;

• коммуникациям;

• ИИ/LLM;

• доказательствам/согласию.

SpecForge

SpecForge остаётся привилегированным потребителем AyA-MCP, но MCP не зависит от него для своего существования.

Инструменты REQ/RN/CT/T, трассируемость, очередь, качество, агенты и aya_validacao_aprovar_saida находятся в наборе инструментов specforge.

Локальный запуск

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

С Agents:

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

VPS / удалённо

npm run start:http

Вне loopback настройте токен и host allowlist в соответствии с .env.exemplo.

Качество

npm run verificar

GitHub Actions выполняет сборку TypeScript и тесты при каждом push/PR.

Основные документы

• 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