ria6-architecture-router-mcp

Pacote genérico — MCP server para arquitetura L0–L6. Funciona em qualquer repositório que tenha AGENTS.md e docs/architecture/doc-index.yaml. Não embute documentação de um projeto específico; roteia a doc local do workspace aberto.

Requisitos

• Node.js 18+
• Cursor com MCP habilitado
• Projeto com estrutura L0–L6 (AGENTS.md, doc-index.yaml)

Build (desenvolvimento)

cd mcp/architecture-router
npm install
npm run build

Cursor config

Opção A — npm (recomendado para times)

.cursor/mcp.json na raiz do projeto alvo (Angular, Vue, meta-repo, etc.):

{
  "mcpServers": {
    "architecture-router": {
      "command": "npx",
      "args": ["-y", "ria6-architecture-router-mcp@^0.1.0"],
      "env": {
        "ARCH_PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

Windows: se spawn npx ENOENT, use "command": "C:\\Program Files\\nodejs\\npx.cmd".

Opção B — path local (monorepo / clone)

{
  "mcpServers": {
    "architecture-router": {
      "command": "node",
      "args": ["mcp/architecture-router/dist/index.js"],
      "env": {
        "ARCH_PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

Reinicie o Cursor → Settings → MCP → status verde.

Tools

| Tool | Description | |---|---| | resolve_intent | Query → intent + docs + skill | | get_architecture_context | Read up to 3 docs for an intent | | get_feature_manifest | Read docs/features/<feat>/MANIFEST.md | | get_file_map_hint | Path hint for L0–L6 artifacts | | doc_sync_checklist | Manifest sections for changed files | | mdpe_plan_template | Prefilled tasks/<slug>.md template |

Resources

• arch://agents — AGENTS.md
• arch://index — doc-index.yaml
• arch://layers — LAYERS.md

Environment

| Variable | Default | Description | |---|---|---| | ARCH_PROJECT_ROOT | cwd | Raiz do projeto com L0–L6 (muda por workspace) |

Multi-projeto

O mesmo pacote npm serve N repositórios. Cada um aponta ARCH_PROJECT_ROOT para o workspace atual e usa seu próprio doc-index.yaml.

License

MIT