STACKOS MCP Server

![MCP Server](https://modelcontextprotocol.io)

MCP Server que expone la knowledge base, metodología, evaluaciones y standards de TRAID Agency como servicio consumible desde cualquier cliente MCP.

Compatible con: Claude Code, ChatGPT, Gemini, Cursor, Windsurf, n8n.

Qué es STACKOS

Sistema de investigación técnica que mantiene documentación siempre actualizada con evaluaciones objetivas de herramientas (ADOPT/HOLD/DROP), papers de investigación, standards de calidad y conocimiento institucional.

Sin RAG, sin vector DB — búsqueda por keyword sobre archivos markdown.

Tools disponibles (16)

Lectura y búsqueda (6)

| Tool | Descripción | |------|-------------| | buscar_evaluacion | Busca evaluación Tech Radar de una herramienta | | buscar_conocimiento | Grep en toda la knowledge base o por área | | listar_skills | Lista skills/metodologías disponibles | | listar_evaluaciones | Lista todas las evaluaciones con clasificación | | leer_standard | Lee un standard de calidad completo | | obtener_contexto_global | Resumen ejecutivo de toda la KB |

Skills y metodología (3)

| Tool | Descripción | |------|-------------| | leer_skill | Lee el workflow completo de un skill (SKILL.md) | | leer_metodologia | Lee SDD-STACKOS, reglas universales o estándar de Engram | | guia_aprendizaje | Guía estructurada para alumnos (principiante/intermedio/avanzado) |

Pedagógicos (4)

| Tool | Descripción | |------|-------------| | modo_tutor | Instrucciones que convierten al agente en tutor pedagógico | | explicar_concepto | Explica conceptos con analogía, ejemplo y verificación | | ejercicio_practico | Genera ejercicios por tema y nivel | | evaluar_respuesta | Evalúa respuesta del alumno con feedback constructivo |

Escritura (3)

| Tool | Descripción | |------|-------------| | registrar_leccion | Registra lección aprendida (append-only) | | agregar_nota_conocimiento | Agrega nota a archivo de knowledge existente | | proponer_evaluacion | Propone herramienta para evaluar |

Para alumnos

Si sos alumno y te compartieron este MCP, empezá así:

modo_tutor — El agente se convierte en tu tutor pedagógico
guia_aprendizaje con nivel "principiante" — te da el roadmap completo
explicar_concepto con "spec" nivel "principiante" — tu primer concepto
ejercicio_practico con "spec" nivel "principiante" — practica lo aprendido
evaluar_respuesta — cuando termines el ejercicio, evaluá tu trabajo

Flujo de una sesión de aprendizaje

modo_tutor → guia_aprendizaje → explicar_concepto → ejercicio_practico → evaluar_respuesta
     ↑                                                                          │
     └──────────────────── siguiente concepto ←─────────────────────────────────┘

Conceptos disponibles (con 3 niveles cada uno)

spec — Especificaciones y OpenSpec v2
skill — Skills y automatizaciones
engram — Sistema de memoria persistente
quality-gate — Quality gates y gobernanza
lifecycle — Ciclo de vida de un proyecto

Resources (8)

| URI | Contenido | |-----|-----------| | stackos://institucional/traid | Marca y stack de TRAID Agency | | stackos://institucional/nahuel | Perfil del co-founder | | stackos://contexto-global | Resumen de toda la KB | | stackos://standards/investigacion | Cómo investigar | | stackos://standards/citacion | Formato de citas | | stackos://standards/evaluacion | Criterios Tech Radar | | stackos://standards/checklist | Checklist pre-publicación | | stackos://indice | Índice de topics y evaluaciones |

Quick Start

Local (stdio)

git clone <este-repo>
cd stackos-mcp
npm install
npm run build
node dist/index.js

Docker (HTTP)

docker compose up -d --build
# Endpoint: http://localhost:3000/mcp
# Health:   http://localhost:3000/health

Configuración

Variables de entorno

| Variable | Default | Descripción | |----------|---------|-------------| | STACKOS_ROOT | D:/OneDrive/GitHub/CONOCIMIENTO-NAHUEL | Ruta a la knowledge base | | MCP_TRANSPORT | stdio | Transporte: stdio o http | | PORT | 3000 | Puerto HTTP | | STACKOS_API_KEY | (vacío) | Bearer token. Si está definido, valida auth |

Claude Code

{
  "mcpServers": {
    "stackos": {
      "type": "stdio",
      "command": "node",
      "args": ["D:/OneDrive/GitHub/stackos-mcp/dist/index.js"],
      "env": { "STACKOS_ROOT": "D:/OneDrive/GitHub/CONOCIMIENTO-NAHUEL" }
    }
  }
}

Remoto (ChatGPT, Gemini, Cursor, n8n)

{
  "stackos": {
    "type": "http",
    "url": "https://tu-servidor.com:3000/mcp",
    "headers": { "Authorization": "Bearer <tu-api-key>" }
  }
}

Licencia

MIT

stackos-mcp