AyA-MCP v0.2

AYA / De Bruin Sistemas의 범용 결정적 MCP 코어.

v0.2는 프로젝트를 회사의 모든 영역으로 확장합니다: 웹 시스템, API, SaaS, 이커머스, 사이트, 모바일/데스크톱, 게임, 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_*;

• 동일한 실패 두 번 -> 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는 두 가지 모델을 결합합니다:

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.

네이티브 outline/references는 의도적으로 어휘적(lexical) 입니다. 의미적으로 올바른 definition/rename/diagnostics/call hierarchy를 얻으려면 승인된 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 필요;

• 경로 탐색(path traversal) 차단;

• 프레임워크 심볼릭 링크는 승인된 루트를 벗어나지 않음;

• .git, node_modules, vendor 및 벤더 스킬은 일반 쓰기로부터 보호됨;

• 편집 전 백업;

• SHA-256은 정밀 편집에서 선택적/필수 전제 조건;

• 로그/감사는 비밀을 정화함;

• 정적 감사는 하드코딩된 비밀, 위험한 셸, eval, 안전하지 않은 TLS, CORS 및 lockfile을 찾음;

• 외부 콘텐츠는 신뢰할 수 없는 데이터로 취급됨;

• 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는 모든 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