AyA-MCP v0.2

AYA / De Bruin Sistemas の普遍的な決定論的 MCP コア。

v0.2 は、プロジェクトを企業のすべての領域（Web システム、API、SaaS、EC、サイト、モバイル/デスクトップ、ゲーム、AI、ブラジル税務、決済、コミュニケーション、データ、セキュリティ、自動化、インフラストラクチャ）に拡大します。

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 + チェックポイント/ハンドオフ;

• 完了前のエビデンス -> aya_evidencia_*;

• 同じ失敗が2回 -> 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.

ゲームレイヤーは、専門の統合機能が利用可能になり次第、v0.2 内でさらに拡張される予定です。

永続メモリ

v0.2 は 2 つのモデルを組み合わせます:

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

ネイティブのアウトライン/参照は、意図的に字句的です。意味的に正しい定義/名前変更/診断/呼び出し階層には、承認済みの LSP/Serena を優先してください。AyA-MCP は 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 が必要;

• パストラバーサルはブロック;

• フレームワークのシンボリックリンクは、許可されたルートから外に出ない;

• .git、node_modules、vendor、およびベンダースキルは、汎用的な書き込みから保護;

• 編集前のバックアップ;

• SHA-256 は、外科的編集におけるオプション/必須の前提条件;

• ログ/監査はシークレットをサニタイズ;

• 静的監査は、ハードコードされたシークレット、危険なシェル、eval、安全でない TLS、CORS、ロックファイルを探す;

• 外部コンテンツは信頼できないデータとして扱われる;

• v0.2 では無制限のシェルはない。

普遍的なマルチエージェントチーム

aya_agentes_planejar_equipe は、プロジェクトに応じて役割を構成します。オーケストレーター、アナリスト、アーキテクト、エグゼキューター、レビュアー、テスター、継続性、クリティックに加えて、以下の専門家を追加できます:

• データ;

• バックエンド;

• フロントエンド;

• モバイル;

• ゲームデザイン;

• エンジン/パフォーマンス;

• セキュリティ;

• DevOps;

• ブラジル税務;

• 決済;

• コミュニケーション;

• AI/LLM;

• エビデンス/同意。

SpecForge

SpecForge は引き続き AyA-MCP の特権的なコンシューマーですが、MCP は SpecForge に依存して存在するわけではありません。

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

ループバック以外では、.env.exemplo に従ってトークンとホスト許可リストを設定してください。

品質

npm run verificar

GitHub Actions は、各プッシュ/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