/ Directorio / Playground / mex
← Todos los servidores ↗ GitHub
● Comunidad theDakshJaitly ⚡ Instantáneo

mex

por theDakshJaitly · theDakshJaitly/mex

Scaffold de memoria de proyecto + detector de deriva — mantiene a los agentes de codificación con IA anclados en el estado real de tu proyecto, no en una instantánea de ayer.

mex instala un scaffold de memoria estructurada en tu repositorio (arquitectura, convenciones, trabajo en curso, bloqueadores) y incluye un CLI que detecta la deriva entre la memoria y la realidad. Cuando los cambios de código contradicen la memoria, el CLI lo señala para que actualices o realinees. Ligero — pensado para vivir en el repositorio y viajar con el equipo.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mex-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mex-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/theDakshJaitly/mex",
        "~/.claude/skills/mex"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "mex-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/theDakshJaitly/mex",
          "~/.claude/skills/mex"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mex-skill -- git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mex

Configurar la memoria del proyecto al inicio de un proyecto

👤 Propietarios de nuevos repositorios ⏱ ~25 min beginner

Cuándo usarlo: Día 1 de un proyecto; quieres que los agentes se pongan al día rápido.

Requisitos previos
  • Skill instalada — git clone https://github.com/theDakshJaitly/mex ~/.claude/skills/mex
Flujo
  1. Inicializar
    Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Copiado
    → Scaffold /.mex/ creado con plantillas
  2. Rellenar semillas
    Auto-extract architecture from existing code and a starter convention list.✓ Copiado
    → Secciones sembradas con contenido inicial
  3. Establecer frescura
    Mark each section verified today.✓ Copiado
    → Marcadores de frescura establecidos

Resultado: El nuevo proyecto comienza con contexto compartido para el agente.

Errores comunes
  • La extracción automática capta detalles irrelevantes — Recorta sin piedad — la memoria es para principios, no para grep
Combinar con: filesystem

Encontrar dónde la memoria del proyecto discrepa con el código

👤 Propietarios de proyectos de larga duración ⏱ ~30 min intermediate

Cuándo usarlo: La memoria se configuró hace meses; nadie está seguro de cuán obsoleta está.

Flujo
  1. Ejecutar la detección de deriva
    Use mex. Run drift detection. Report claims that no longer match reality.✓ Copiado
    → Informe de deriva con afirmación ↔ evidencia
  2. Actualizar o eliminar
    For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Copiado
    → Decisión por ítem; PRs abiertos para correcciones del lado del código
  3. Volver a verificar
    After resolving, mark sections verified today.✓ Copiado
    → Memoria alineada de nuevo

Resultado: La memoria permanece como un contrato fiable, no como folclore.

Errores comunes
  • El detector de deriva señala demasiado agresivamente — Ajusta --strictness; usa 'medium' para proyectos vivos
Combinar con: github

Transferir trabajo en curso entre miembros del equipo

👤 Devs de vacaciones / que se van ⏱ ~20 min beginner

Cuándo usarlo: Tienes 3 funcionalidades en progreso y alguien más necesita recogerlas.

Flujo
  1. Capturar lo en curso
    Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Copiado
    → Entradas en /.mex/in-flight/
  2. Verificar con el CLI
    Run drift on in-flight; ensure entries reflect actual branch state.✓ Copiado
    → Deriva limpia
  3. Transferir
    Generate a teammate-ready summary linking each entry to its branch.✓ Copiado
    → Resumen listo para Slack/email

Resultado: Recogida fluida; sin arqueología requerida.

Errores comunes
  • Entradas en curso vagas ('trabajando en X') — Fuerza el campo 'próximos pasos' de la plantilla; concreto o no ayuda

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mex-skill + filesystem

La memoria vive en el repositorio; haz commit

Commit /.mex/ to git so memory travels with the codebase.✓ Copiado
mex-skill + github

Verificación de deriva en CI en PRs

On every PR, run mex drift and post the report as a PR comment.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
init scaffold_options Una vez por proyecto 0
drift section?, strictness? Semanal / antes de fusionar ramas de larga duración 0 (uses local checks + LLM for fuzzy claims)
verify section Después de actualizar la memoria para que coincida con la realidad 0
in_flight_add branch, goal, next_steps Al iniciar una rama de funcionalidad 0
summary format Transferencia / informe de estado 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Ninguna — local
Tokens por llamada
La deriva usa LLM para afirmaciones difusas; limitado por ejecución
Monetario
Gratuito
Consejo
Usa strict=high en CI para detectar deriva real; medium para comprobaciones locales diarias

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: filesystem-write
Almacenamiento de credenciales: Ninguna
Salida de datos: Ninguna a menos que el LLM de deriva esté configurado con un proveedor remoto

Resolución de problemas

Errores comunes y soluciones

La deriva reporta falsos positivos

Baja la rigurosidad; o refina la redacción de las afirmaciones para que sean más verificables

La memoria crece sin límite

Cada sección tiene un límite suave; consolida periódicamente — conserva los principios, archiva los detalles específicos

El CLI no encuentra /.mex/

Ejecuta desde la raíz del repositorio; o pasa --root <path>

La extracción automática omite invariantes clave

La extracción automática es solo un punto de partida; escribe a mano los invariantes carga-bearing

Alternativas

mex vs otros

AlternativaCuándo usarlaContrapartida
claude-mem-skillQuieres continuidad de sesión, no memoria de conocimiento del proyectoProblema diferente; mex es para invariantes a nivel de proyecto
Plain CLAUDE.mdProyecto pequeño, sin necesidad de detección de derivaSin estructura; sin comprobaciones automáticas de frescura
pilot-shell-skillQuieres spec/plan/gates además de persistencia de conocimientoMayor superficie de flujo de trabajo; más opiniones

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills