drift MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Detección de patrones: infiere automáticamente las convenciones de tu código real
Memoria de decisiones: notas de escritura única que persisten entre sesiones
Multilenguaje: TypeScript, Rust, Java, Python, C#, PHP
MCP + CLI sin conexión — el mismo motor, dos interfaces
Primero local: todos los datos almacenados en tu disco, nada se carga

Demo en vivo

Cómo se ve en la práctica

drift.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "drift": {
      "command": "uvx",
      "args": [
        "drift"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "drift": {
      "command": "uvx",
      "args": [
        "drift"
      ],
      "_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": {
    "drift": {
      "command": "uvx",
      "args": [
        "drift"
      ],
      "_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": {
    "drift": {
      "command": "uvx",
      "args": [
        "drift"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "drift",
      "command": "uvx",
      "args": [
        "drift"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "drift": {
      "command": {
        "path": "uvx",
        "args": [
          "drift"
        ]
      }
    }
  }
}

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

claude mcp add drift -- uvx drift

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

Casos de uso

Usos del mundo real: drift

Integra un asistente de IA a las convenciones de tu base de código

👤 Líderes técnicos cansados de recordarle a Claude 'no, aquí no usamos clases' ⏱ ~20 min beginner

Cuándo usarlo: Primera sesión en un nuevo repositorio, o después de un refactor grande que cambió las convenciones.

Requisitos previos

drift instalado — uvx drift o instalar globalmente

Flujo

Ejecuta el escaneo inicial

Ejecuta drift scan en este repositorio. Dime qué patrones detectaste alrededor del manejo de errores, estructura de módulos y nombres.✓ Copiado

→ Resumen de convenciones concretas con ejemplos
Registra las decisiones que quieres preservar

Registra estas decisiones del equipo: usamos Result<T,E> en lugar de excepciones, un controlador por carpeta de características, snake_case para nombres de archivos. Etiquétalas 'conventions'.✓ Copiado

→ Confirmación; entradas consultables después
Verifica que futuras sesiones lo detecten

En una nueva sesión: ¿qué convenciones sigue este repositorio?✓ Copiado

→ Claude recita las decisiones que registraste

Resultado: Cada sesión futura de IA comienza con las convenciones de tu equipo cargadas — menos correcciones, chats más productivos.

Errores comunes

Los patrones se infieren del código existente, incluyendo código malo — Revisa el escaneo inicial y elimina cualquier 'convención' que sea en realidad deuda técnica que intentas evitar
La memoria de decisiones se desvía de la realidad si olvidas actualizarla — Trata las entradas de memoria como documentación — revisa trimestralmente

Combinar con: filesystem · github

Aplica las convenciones del equipo durante la revisión de PR

👤 Revisores de código ⏱ ~10 min intermediate

Cuándo usarlo: Antes de aprobar un PR, verifica que no haya roto silenciosamente los patrones del equipo.

Flujo

Carga el diff de este PR

Carga el diff para PR #213 y compáralo contra las convenciones que drift ha registrado.✓ Copiado

→ Lista de coincidencias y desviaciones de convenciones
Redacta comentarios de revisión para las desviaciones

Para cada desviación, redacta un comentario de revisión educado citando la convención.✓ Copiado

→ Texto de comentario por hallazgo

Resultado: Revisiones de PR consistentes sin que el revisor tenga que recordar cada regla no escrita.

Errores comunes

Los nuevos patrones pueden ser intencionales — no seas dogmático — Permite que el autor anule con una decisión de 'nuevo patrón' que se registra para futuros PRs

Combinar con: github

Mantén un registro ligero de decisiones arquitectónicas

👤 Cualquier equipo que siga olvidando por qué se tomaron las decisiones ⏱ ~5 min beginner

Cuándo usarlo: En lugar de una carpeta de ADR formal que nadie actualiza.

Flujo

Registra una decisión cuando se toma

Registra la decisión: elegimos Postgres sobre DynamoDB por necesidades de consultas ad-hoc. Fecha hoy. Etiquetas: db, architecture.✓ Copiado

→ Entrada guardada con ID
Consulta después cuando la pregunta regrese

¿Por qué elegimos Postgres?✓ Copiado

→ La decisión almacenada se mostrará

Resultado: Memoria institucional que sobrevive los cambios de personal.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

drift + filesystem

drift conoce las convenciones, filesystem realiza los cambios

Usa las convenciones que drift ha registrado, refactoriza src/api/users.ts para que coincidan. Usa filesystem para aplicar los cambios.✓ Copiado

drift + github

Revisa los PRs entrantes contra las convenciones registradas

Obtén PR #88, verifica contra las convenciones de drift, redacta comentarios de revisión para cualquier desviación.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
scan_codebase	path: str	Primera sesión, o después de refactors grandes	gratis; vinculado a CPU
list_conventions	tag?: str	Carga el contexto al inicio de la sesión	gratis
record_decision	title: str, body: str, tags?: str[]	Cuando el equipo acuerda algo no obvio	gratis
query_memory	query: str	Cuando Claude debe recordar contexto pasado	gratis (embeddings locales)
detect_pattern	area: str	Ad-hoc '¿cómo normalmente hacemos X aquí?'	gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — completamente local
Tokens por llamada: Resúmenes de convenciones: ~1k tokens. Los volcados de escaneo completo pueden ser 10k+
Monetario: Gratuito y de código abierto
Consejo: Carga resúmenes de convenciones al inicio de la sesión, no el escaneo completo. Escaneo completo solo en refactors.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Solo SQLite local o sistema de archivos

Salida de datos: Ninguno por defecto — se ejecuta completamente sin conexión

La memoria de decisiones puede contener contexto sensible del negocio. Añade el directorio de datos de drift a .gitignore.
Si habilitas características de sincronización en la nube, revisa qué se está saliendo de la máquina.

Resolución de problemas

Errores comunes y soluciones

El escaneo se cuelga en un monorepo grande

Excluye directorios generados y vendor a través de .driftignore (misma sintaxis que .gitignore).

Verificar: drift scan --dry-run

La consulta de memoria no devuelve nada relevante

Reconstruye el índice de embeddings local; las nuevas decisiones no aparecen hasta que se indexan.

Verificar: drift reindex

Claude no usa las convenciones registradas

Asegúrate de que el MCP esté listado primero en tu configuración del cliente para que su contexto se cargue al inicio de cada sesión.

Verificar: claude mcp list

Alternativas

drift vs otros

Alternativa	Cuándo usarla	Contrapartida
MARM-Systems	Quieres memoria general entre sesiones no específica del código	Menos consciente del código; notas más generales
llm-context.py	Quieres agrupación de código basada en reglas en lugar de memoria	Sin capa de persistencia
Plain ADRs in the repo	Prefieres documentación como código	La IA tiene que leerlas en cada sesión — mayor costo de tokens

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills