@diazpolanco13/context-control-mcp/README.md

🔥 Context Control MCP v5.0 PORTABLE EDITION - Análisis universal de proyectos que funciona en CUALQUIER entorno. Contexto completo automático para IA.

# 🔥 Context Control MCP v5.0 "PORTABLE EDITION"

> **ANÁLISIS UNIVERSAL: Funciona en CUALQUIER proyecto, CUALQUIER entorno, CUALQUIER estructura. Contexto completo automático para IA.**

[![npm version](https://badge.fury.io/js/%40diazpolanco13%2Fcontext-control-mcp.svg)](https://www.npmjs.com/package/@diazpolanco13/context-control-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/node/v/@diazpolanco13/context-control-mcp.svg)](https://nodejs.org/)

**Context Control MCP v5.0** proporciona **contexto completo automático** para nuevas sesiones de IA, incluyendo historial de versiones, arquitectura detectada, y análisis inteligente de gaps críticos. **100% portable** - funciona sin dependencias externas.

---

## 🎯 **Problema Resuelto**

Las sesiones de IA pierden contexto al cambiar de chat. **Context Control MCP** proporciona contexto completo automáticamente, incluyendo historial de cambios, para que cualquier IA pueda continuar el trabajo inmediatamente.

---

## ⚡ **Características Principales**

### 🔍 **Análisis Completo Automático**
- **Detección de entorno**: OS, Node.js, Git, NPM
- **Análisis de proyecto**: Tipo, versión, dependencias
- **Arquitectura detectada**: Framework, BD, auth, testing
- **Historial de versiones**: Commits recientes y cambios importantes
- **Gaps críticos**: Problemas que bloquean el desarrollo

### 🚀 **100% Portable**
- **Sin dependencias**: No requiere `@modelcontextprotocol/sdk`
- **Funciona en cualquier entorno**: Linux, macOS, Windows
- **Cualquier estructura**: MCP, Next.js, React, Vue, Express, etc.
- **Degradación inteligente**: Funciona aunque falten herramientas

### 🎯 **Dos Comandos Esenciales**
- **`npm run analyze`** - Contexto completo con historial para nueva IA
- **`npm run dashboard`** - Vista rápida del estado del proyecto

---

## 🚀 **Instalación y Uso**

### **Instalación Global**
```bash
npm install -g @diazpolanco13/context-control-mcp
```

### **Uso en Cualquier Proyecto**
```bash
# Contexto completo para nueva sesión de IA
ccmcp-analyze

# Dashboard rápido del proyecto
ccmcp-dashboard
```

### **Instalación Local**
```bash
npm install @diazpolanco13/context-control-mcp
npm run analyze    # Contexto completo
npm run dashboard  # Vista rápida
```

---

## 🔧 **Integración con Cursor IDE**

Para usar Context Control MCP directamente en Cursor:

1. **Abrir configuración MCP** en Cursor
2. **Agregar nuevo servidor** con:
```json
{
  "command": "node",
  "args": ["/ruta/a/tu/proyecto/context-control-cursor.cjs"],
  "cwd": "/ruta/a/tu/proyecto"
}
```
3. **Reiniciar Cursor**

---

## 📊 **Ejemplo de Salida**

```
🔥 ANÁLISIS PORTABLE COMPLETADO
═══════════════════════════════════════════════

🌍 ENTORNO DETECTADO:
• Sistema: linux (linux)
• Node.js: v18.17.0
• Git: Disponible
• NPM: Disponible

📊 PROYECTO DETECTADO:
• Nombre: mi-proyecto v1.0.0
• Tipo: Next.js App
• Scripts: 8 comandos disponibles

🏗️ ARQUITECTURA DETECTADA:
• Framework: Next.js
• Base de datos: Prisma
• Autenticación: NextAuth
• Testing: Jest

📁 ESTRUCTURA ANALIZADA:
• Total archivos: 45
• Archivos de código: 32
• Componentes: 12
• Páginas: 8
• APIs: 6

🚨 PROBLEMAS DETECTADOS (1):
1. ⚠️ [HIGH] Existe .env.example pero no .env
   💥 Impacto: Aplicación podría no funcionar
   🔧 Acción: Copiar .env.example a .env

💡 PRÓXIMO PASO INTELIGENTE:
• Prioridad: ALTA
• Acción: Configurar variables de entorno
• Tiempo estimado: 1 horas
```

---

## 🛠️ **Archivos Principales**

- **`ccmcp-full-context.cjs`** - Análisis completo con historial
- **`ccmcp-portable.cjs`** - Dashboard rápido portable  
- **`context-control-cursor.cjs`** - Servidor MCP para Cursor

---

## 🎯 **Casos de Uso**

### **Para Desarrolladores**
```bash
# Al iniciar trabajo en proyecto existente
ccmcp-analyze

# Verificación rápida del estado
ccmcp-dashboard
```

### **Para IA/Asistentes**
```bash
# Obtener contexto completo antes de ayudar
ccmcp-analyze

# Dashboard para métricas rápidas
ccmcp-dashboard
```

### **Para Equipos**
```bash
# Handoff entre desarrolladores
ccmcp-analyze > handoff-context.md

# Status check rápido
ccmcp-dashboard
```

---

## 📈 **Beneficios**

- ✅ **Contexto completo automático** - No más explicaciones manuales
- ✅ **100% portable** - Funciona en cualquier proyecto/entorno
- ✅ **Sin dependencias problemáticas** - No más errores de SDK
- ✅ **Análisis inteligente** - Detecta problemas antes que se vuelvan críticos
- ✅ **Historial incluido** - La IA conoce la evolución del proyecto
- ✅ **Setup en segundos** - `npm install` y listo

---

## 🤝 **Contribuir**

1. Fork el repositorio
2. Crea tu rama de feature (`git checkout -b feature/AmazingFeature`)
3. Commit tus cambios (`git commit -m 'Add AmazingFeature'`)
4. Push a la rama (`git push origin feature/AmazingFeature`)
5. Abre un Pull Request

---

## 📄 **Licencia**

Distribuido bajo la Licencia MIT. Ver `LICENSE` para más información.

---

## 👨‍💻 **Autor**

**Carlos Diaz** - [@diazpolanco13](https://github.com/diazpolanco13)

- Email: diazpolanco13@gmail.com
- GitHub: [context-control-mcp](https://github.com/diazpolanco13/context-control-mcp)

---

## 🙏 **Agradecimientos**

- Comunidad de desarrolladores que probaron las versiones beta
- Feedback de usuarios que ayudó a mejorar la portabilidad
- Proyecto Model Context Protocol por la inspiración

---

**🔥 Context Control MCP v5.0 "PORTABLE EDITION" - Análisis universal que funciona SIEMPRE** 🔥