AyA-MCP v0.2

AYA / De Bruin Sistemas 的通用确定性 MCP 核心。

v0.2 将项目扩展到公司的所有领域：Web 系统、API、SaaS、电子商务、网站、移动/桌面、游戏、AI、巴西财税、支付、通信、数据、安全、自动化和基础设施。

pre-1.0 版本线。package.json 按 SemVer/npm 使用 0.2.0；公开版本为 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;

• 无 BOM 的 UTF-8 -> aya_arquivo_encoding_validar;

• 连续性 -> aya_memoria_agents_inicializar + checkpoint/handoff;

• 完成前先有证据 -> aya_evidencia_*;

• 两次相同失败 -> aya_loop_falha_registrar 产生阻断;

• 路由/技能/包 -> aya_framework_*;

• 框架治理 -> aya_framework_governanca_auditar;

• 模板优先 -> 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.

Games 层将在 v0.2 中继续扩展，并在可用时提供专门集成。

持久记忆

v0.2 结合两种模式：

1. 用于 LLM 之间连续性的操作记忆/checkpoint/handoff；

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.

原生大纲/引用是刻意词法层面的。对于语义正确的 definition/rename/diagnostics/call hierarchy，应优先使用经批准的 LSP/Serena。AyA-MCP 不调用 LSP 的 regex。

工具集

默认情况下，所有能力都会被注册：

AYA_TOOLSETS=all

对于较小的 LLM，请减少 schemas：

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;

• 阻止路径遍历;

• 框架的符号链接不会逃逸出授权根目录;

• .git、node_modules、vendor 和供应商技能受保护，不允许通用写入;

• 编辑前备份;

• SHA-256 作为外科手术式编辑的可选/强制前提条件;

• 日志/审计会清洗机密;

• 静态审计查找硬编码机密、危险 shell、eval、不安全的 TLS、CORS 和锁文件;

• 外部内容被视为不可信数据;

• v0.2 中没有任何不受限制的 shell。

通用多智能体团队

aya_agentes_planejar_equipe 根据项目组建角色。除了编排者、分析师、架构师、执行者、审查者、测试者、连续性和批评者之外，还可以添加以下领域的专家：

• 数据;

• 后端;

• 前端;

• 移动端;

• 游戏设计;

• 引擎/性能;

• 安全;

• DevOps;

• 巴西财税;

• 支付;

• 通信;

• AI/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 之外，请按照 .env.exemplo 配置 token 和主机白名单。

质量

npm run verificar

GitHub Actions 在每次 push/PR 时执行 TypeScript 构建和测试。

主要文档

• 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