AyA-MCP v0.2

Universeller deterministischer MCP-Kern von AYA / De Bruin Sistemas.

Die v0.2 erweitert das Projekt auf alle Unternehmensbereiche: Websysteme, APIs, SaaS, E-Commerce, Websites, Mobile/Desktop, Spiele, KI, brasilianisches Steuerwesen, Zahlungen, Kommunikation, Daten, Sicherheit, Automatisierung und Infrastruktur.

Vor-1.0-Linie. Die package.json verwendet 0.2.0 gemäß SemVer/npm; die öffentliche Version ist v0.2.

Ziel

Reduzieren, wie viel eine LLM sich merken, interpretieren und improvisieren muss. Wann immer eine wichtige Regel zu Code, Gate, Tool, Resource, Schema, Evidence oder Policy werden kann, sollte AyA-MCP dies einer losen textuellen Anweisung vorziehen.

Related MCP server: mcp-tool-server

Integration mit dem Paket Agents

Das private Paket Agentes de IA ist eine funktionale Quelle der v0.2. Konfigurieren Sie:

AYA_FRAMEWORK_AGENTS_ROOT=/caminho/Agentes-de-IA

Das MCP inventarisiert und routet Laufzeiten, Agenten, Skills, spezialisierte Packs, Vorlagen und Vendor-Skills, ohne Tausende von Dateien in den Kontext zu laden.

Proprietärer Inhalt von Agents wird nicht kopiert in dieses öffentliche Repository.

Agents-Regeln in Verhalten transformiert

• Backup vor dem Bearbeiten -> aya_arquivo_escrever_seguro;

• sofortiges Log -> aya_execucao_log_registrar;

• UTF-8 ohne BOM -> aya_arquivo_encoding_validar;

• Kontinuität -> aya_memoria_agents_inicializar + Checkpoint/Handoff;

• Evidenz vor Fertigstellung -> aya_evidencia_*;

• zwei identische Fehler -> aya_loop_falha_registrar erzeugt eine Sperre;

• Routing/Skills/Packs -> aya_framework_*;

• Framework-Governance -> aya_framework_governanca_auditar;

• Template-first -> aya_template_primeiro_planejar;

• Modellprivatsphäre -> aya_modelo_privacidade_avaliar;

• schwache LLM -> aya_modelo_perfil_execucao + Toolsets/selektiver Kontext.

Spiele

Spiele sind eine Domäne erster Klasse.

Zunächst erkannte Engines:

• Godot;

• Unity;

• Unreal Engine;

• Phaser;

• Three.js/WebGL;

• Flutter/Flame;

• libGDX;

• GameMaker;

• Defold;

• Ren'Py;

• LÖVE2D.

Tools:

• aya_games_detectar_engine;

• aya_games_assets_inventariar;

• aya_games_validar;

• aya_games_checklist.

Die Spiele-Ebene wird noch in v0.2 mit spezialisierten Integrationen erweitert, sobald diese verfügbar sind.

Persistenter Speicher

Die v0.2 kombiniert zwei Modelle:

1. operationeller Speicher/Checkpoint/Handoff für Kontinuität zwischen LLMs;

2. Projekt-Graphenspeicher, inspiriert vom Memory-MCP-Server.

Resource:

aya://projeto/memoria-grafo

Tools:

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

Geheimnisse werden bereinigt, bevor Beobachtungen persistiert werden.

Code und Kontextersparnis

Inspiriert von Serena und mcp-language-server hat AyA-MCP eine leichte native Schicht erhalten:

• aya_codigo_outline;

• aya_codigo_referencias;

• aya_codigo_editar_linhas;

• aya_codigo_semantico_planejar.

Die nativen Outline/Referenzen sind bewusst lexikalisch. Für semantisch korrekte Definition/Rename/Diagnostics/Call-Hierarchy sollte das genehmigte LSP/Serena bevorzugt werden. AyA-MCP ruft kein LSP-Regex auf.

Toolsets

Standardmäßig sind alle Fähigkeiten registriert:

AYA_TOOLSETS=all

Für eine kleinere LLM: Schemas reduzieren:

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

Verfügbare Toolsets:

• specforge;

• agents;

• games;

• codigo;

• arquivos;

• memoria;

• seguranca;

• mcps;

• evidencias;

• templates;

• equipe.

Verwenden Sie aya_toolsets_sugerir, um ein minimales Set pro Aufgabe zusammenzustellen.

Recherchierte externe MCPs

Die v0.2 hat offene Projekte untersucht, um bewährte Praktiken zu übernehmen:

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

Details in docs/MCPs-ABERTOS-APROVEITADOS-v0.2.md und config/mcps-abertos-pesquisados-v0.2.json.

AyA installiert keine unbekannten MCPs automatisch.

Sicherheit

• Workspace fixiert auf AYA_WORKSPACE_ROOT;

• read-only standardmäßig;

• Schreibzugriff erfordert AYA_MODO_ESCRITA=true;

• Path-Traversal blockiert;

• Framework-Symlinks verlassen die autorisierte Wurzel nicht;

• .git, node_modules, vendor und Vendor-Skills vor generischem Schreiben geschützt;

• Backup vor der Bearbeitung;

• SHA-256 als optionale/obligatorische Vorbedingung bei chirurgischen Bearbeitungen;

• Logs/Audits bereinigen Geheimnisse;

• statische Prüfung sucht nach hartkodierten Geheimnissen, gefährlicher Shell, eval, unsicherem TLS, CORS und Lockfiles;

• externe Inhalte werden als nicht vertrauenswürdige Daten behandelt;

• keine uneingeschränkte Shell in v0.2.

Universelles Multiagenten-Team

aya_agentes_planejar_equipe stellt Rollen passend zum Projekt zusammen. Neben Orchestrator, Analytiker, Architekt, Executor, Reviewer, Tester, Kontinuität und Kritiker können Spezialisten hinzugefügt werden für:

• Daten;

• Backend;

• Frontend;

• Mobile;

• Game Design;

• Engine/Performance;

• Sicherheit;

• DevOps;

• brasilianisches Steuerwesen;

• Zahlungen;

• Kommunikation;

• KI/LLM;

• Evidenz/Einwilligung.

SpecForge

SpecForge bleibt ein privilegierter Konsument von AyA-MCP, aber das MCP hängt in seiner Existenz nicht von ihm ab.

Die Werkzeuge REQ/RN/CT/T, Rückverfolgbarkeit, Warteschlange, Qualität, Agenten und aya_validacao_aprovar_saida befinden sich im Toolset specforge.

Lokale Ausführung

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

Mit Agents:

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

VPS / Remote

npm run start:http

Außerhalb von Loopback konfigurieren Sie Token und Host-Allowlist gemäß .env.exemplo.

Qualität

npm run verificar

GitHub Actions führt bei jedem Push/PR einen TypeScript-Build und Tests aus.

Hauptdokumente

• 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