Ecosistema de servidores Claude MCP

🚨 CRÍTICO: Dos cuestiones que siguen causando problemas

1. SE REQUIERE CONFIGURACIÓN GLOBAL

• Las configuraciones de MCP DEBEN ser globales ( ~/.claude/claude_code_config.json ), NO locales/específicas del proyecto

• Las configuraciones locales se pierden al cambiar de directorio

2. SE REQUIERE TRANSPORTE AL ESTUDIO

• TODOS los servidores MCP DEBEN usar comunicación STDIO, NO HTTP/puertos

• Claude Code solo admite el transporte STDIO

Solución rápida para problemas de MCP:

# If MCP tools not working in Claude Code:
exit  # Exit current session  
claude --mcp-config ~/.claude/claude_code_config.json  # Restart with global config

Estado : ✅ ARQUITECTURA DE SISTEMA OPTIMIZADA IMPLEMENTADA (2025-05-26)
Servidores : 13 configurados (optimizados de 17 a 13 mediante consolidación)
Herramientas : más de 150 disponibles, incluidos análisis de datos consolidados y optimización de memoria mejorada
Memoria : reducción del 58 % en la sobrecarga de memoria mediante la consolidación de servidores

Related MCP server: MCP Claude Code

⚡ INICIO INSTANTÁNEO (60 SEGUNDOS)

1. Verificar el estado del sistema:

bash verify-system-status.sh

2. Iniciar el ecosistema MCP:

Opción A - PM2 (Recomendada para producción):

./start-mcp-pm2.sh

Opción B - CLI (heredada):

./claude-mcp-setup start

Se esperaba : "Los 11 servidores están listos, ninguno falló"

3. Prueba en Claude Code:

/mcp

Se espera : 11 servidores conectados listados (incluidos con memoria mejorada)

📚 DOCUMENTACIÓN

🚀 EMPIEZA AQUÍ

• ⚡ INICIO INMEDIATO : START_HERE_IMMEDIATE.md - Dónde estás ahora, qué hacer a continuación

• 💻 ESTADO DEL ENTORNO : DEVELOPMENT_ENVIRONMENT_STATUS.md - Estado actual del sistema, estado del proceso, validación

• ⌨️ REFERENCIA DE COMANDOS : COMMAND_REFERENCE_IMMEDIATE.md - Copiar y pegar comandos listos para todas las tareas

📖 DOCUMENTACIÓN COMPLETA

• ⚡ Última sesión : SESSION_2025-05-26_SYSTEM_OPTIMIZATION.md - Consolidación de servidores, optimización de memoria y mejoras de rendimiento

• 📊 Resumen de optimización : OPTIMIZATION_SUMMARY_2025-05-26.md - Resumen ejecutivo de los resultados de optimización

• 📖 Estado actual : CURRENT_WORKING_STATE.md - Actualizado con optimizaciones de la sesión 2025-05-26

• 🧠 Sesión anterior : SESSION_2025-05-25_ENHANCED_MEMORY_IMPLEMENTATION.md - Sistema de memoria mejorado + correcciones de MCP

• Guía completa : README_AUTHORITATIVE_2025-05-24.md

• 📁 Documentos históricos : docs/archive/ (solo para referencia)

🎯 ¿QUÉ ES ESTE PROYECTO?

Un ecosistema de servidor MCP listo para producción que le brinda a Claude AI más de 150 herramientas especializadas en:

• 📊 Análisis de datos consolidados (más de 40 herramientas): servidor unificado que combina pipelines, almacenamiento, gobernanza, implementación de ML y análisis en tiempo real

• 🧠 Memoria mejorada (3 herramientas): 6 técnicas de optimización que incluyen compresión de contexto, memoria jerárquica y fragmentación semántica

• 🔐 Seguridad (6 herramientas): Análisis de vulnerabilidades, verificación de cumplimiento

• 🎨 Diseño (8 herramientas): Análisis de UI, accesibilidad, sistemas de diseño

• 💾 Gestión de memoria (5 herramientas): almacenamiento persistente, gestión de contexto

• ⚡ Optimización (5 herramientas): Perfiles de rendimiento, análisis de cuellos de botella

• 🏗️ Infraestructura (más de 85 herramientas): Base de datos, Docker, gestión de configuración

Optimización clave (26/05/2025) : se consolidaron 5 servidores de análisis de datos separados en 1 servidor unificado, lo que redujo el uso de memoria en ~350 MB y mantuvo la funcionalidad completa.

Infraestructura : PostgreSQL + Redis + Qdrant + orquestación Docker

⚠️ IMPORTANT

Si observa algún problema :

1. Ejecute bash verify-system-status.sh para realizar el diagnóstico

2. Consulte README_AUTHORITATIVE_2025-05-24.md para solucionar problemas

3. Ignorar otros archivos Markdown (contienen información obsoleta)

Última verificación : 24/05/2025
Causa raíz corregida : configuración de la variable de entorno claude-mcp-wrapper.sh
Resultado : Los 10 servidores funcionan con 149 herramientas disponibles