Claude Project Coordinator

CPC es un servidor MCP que le da a Claude una vista estructurada y en disco de tus proyectos: estado, notas, stack tecnológico, actividad y salud. Se ejecuta en macOS junto a Claude Desktop, Cursor o Claude Code. Los datos nunca salen de tu máquina.

v1.4.0 · SDK oficial de Swift MCP · MIT · base de conocimiento JSON local

---

¿Para quién es esto?

Elige el camino que te corresponda. Mismo binario, diferentes primeras preguntas.

1. Aficionado a Swift con múltiples proyectos

Tienes varias aplicaciones y paquetes. Los cambios de contexto consumen tiempo y olvidas qué repo estaba a mitad de una refactorización.

Empieza con:

• "Agrega mi WeatherApp en ~/Developer/WeatherApp"
• "Muéstrame todos mis proyectos rastreados"
• "¿Qué proyectos necesitan mi atención?"
• "Actualiza el estado de WeatherApp a 'Modelos de Core Data a medio hacer'"

Lo que obtienes: un registro vivo con estado, notas, tecnología auto-detectada (SwiftUI, SPM, proyecto/workspace de Xcode) y una puntuación de salud para que los proyectos silenciosos vuelvan a aparecer.

2. Usuario diario de Claude Desktop

Claude es tu escritorio de codificación. Quieres continuidad entre chats sin pegar la misma lista de proyectos.

Empieza con:

• "Lista mis proyectos y su estado actual"
• "¿Qué está pasando con TodoApp?"
• "Encuentra todos los patrones SwiftUI que hemos almacenado"
• "Muestra mi actividad de proyectos esta semana"

Lo que obtienes: Claude puede llamar a nueve herramientas MCP contra tu KnowledgeBase en lugar de adivinar desde la memoria de conversación.

3. Usuario de agente Cursor o Claude Code

Los agentes escriben código bien pero pierden la vista de portafolio. Quieres que el agente sepa en cuál proyecto está y si ese proyecto está saludable.

Empieza con:

• Conecta CPC a la configuración MCP de Cursor / Claude Code (ver Instalación)
• "Obtén el estado del proyecto para Claude-Project-Coordinator"
• "Obtén tendencias tecnológicas en mis proyectos rastreados"
• "Muestra un mapa de calor de actividad de 14 días"

Lo que obtienes: salud del proyecto y cronogramas como resultados de herramientas sobre los que el agente puede actuar, junto a los archivos que ya ve.

4. Configuración centrada en la privacidad / solo local

No enviarás un inventario de proyectos a una herramienta de gestión de proyectos en la nube. Todo debe vivir junto al binario.

Empieza con:

• Compila desde el código fuente, apunta MCP a .build/release/project-coordinator
• Opcional: CPC_KNOWLEDGE_BASE=~/Library/Application Support/CPC para datos fuera del árbol git
• Mantén KnowledgeBase/projects/*.json fuera de repos públicos (ya está en gitignore)

Lo que obtienes: JSON en disco, lista blanca de rutas, sin cuenta, sin telemetría.

5. Ya usas un MCP de memoria

Guardas decisiones y personas en Memory Service (o similar). No quieres un segundo volcado de conversación.

Cómo encajan:

	CPC	Memory MCP
Trabajo	Artefactos y estado del proyecto	Contexto conversacional y decisiones
Forma	Herramientas estructuradas + archivos JSON	Notas, etiquetas, búsqueda
Pregunta	"¿Qué proyectos están obsoletos?"	"¿Qué decidimos sobre la incorporación?"

Usa ambos. No reemplaces uno con el otro.

---

Lista completa de características

Escritorio de proyectos

Capacidad	Detalle
Rastrear muchos proyectos	Nombre, ruta, descripción, estado, notas, tareas actuales, última modificación
Agregar desde una ruta	Valida la ruta, escanea la carpeta, almacena un registro JSON
Actualizar estado / notas	Mantiene el escritorio al día sin una aplicación separada
Listar todo	Un prompt → registro completo con stack tecnológico
Inmersión por proyecto	Estado, notas, tareas, ruta, tecnologías detectadas

Auto-detección

Cuando agregas un proyecto, CPC inspecciona la carpeta y etiqueta lo que encuentra:

• Swift Package Manager (Package.swift)
• Proyecto de Xcode (.xcodeproj)
• Workspace de Xcode (.xcworkspace)
• SwiftUI (import SwiftUI en archivos Swift escaneados)
• Recurre a Swift cuando nada más coincide

Búsqueda y base de conocimiento

Capacidad	Detalle
Búsqueda de patrones	Busca en proyectos rastreados y en el markdown de KnowledgeBase
Guías integradas	Patrones de Swift, prácticas de SwiftUI, atajos de Xcode, solución de problemas
Plantillas	Documentos iniciales en KnowledgeBase/templates/
Tus propios documentos	Coloca markdown en patterns/, tools/ o templates/ y la búsqueda lo recogerá

Analíticas (automáticas)

No hay una aplicación de temporizador separada. Las actualizaciones de estado y el uso de herramientas alimentan las analíticas en segundo plano.

Herramienta	Qué responde
get_project_timeline	¿Cuánto tiempo ha estado este proyecto en cada estado? ¿Qué antigüedad tiene?
get_activity_heatmap	¿Qué proyectos estuvieron activos en los últimos N días?
get_technology_trends	¿Qué frameworks dominan? ¿Qué está emergiendo?
get_project_health	Puntuación de 0 a 100 más recomendaciones (actividad, frescura, documentación, tareas)

Ejemplo de salida de chat: ANALYTICS-EXAMPLES.md.

Seguridad y almacenamiento

Capacidad	Detalle
JSON local	KnowledgeBase/projects/ y archivos de analíticas en tu Mac
Lista blanca de rutas	Solo bajo raíces configuradas (por defecto: Developer, Documents, GitHub, Projects, …)
Límites de entrada	Nombre, ruta, notas y longitud de búsqueda limitados
Comprobaciones de inyección	Patrones de búsqueda examinados para cargas tipo shell
Anulación por entorno	CPC_KNOWLEDGE_BASE para un directorio de datos personalizado
Registros seguros para stdio	Los diagnósticos van solo a stderr (los hosts MCP son dueños de stdout)

---

Todas las herramientas MCP

Herramienta	Parámetros	Propósito
list_projects	—	Listar cada proyecto rastreado
add_project	name, path, opcional description	Registrar un proyecto y auto-detectar tecnología
get_project_status	projectName	Detalle completo de un proyecto
update_project_status	projectName, opcional status, notes	Actualizar la entrada del escritorio
search_code_patterns	pattern	Buscar proyectos + base de conocimiento
get_project_timeline	projectName	Historial de estados y duraciones
get_activity_heatmap	opcional days (por defecto 7)	Mapa de calor de actividad
get_technology_trends	—	Uso de frameworks en todo el portafolio
get_project_health	—	Puntuaciones de salud y recomendaciones

Hablas en lenguaje natural. El host asigna tus palabras a estas herramientas.

---

Flujo de trabajo de ejemplo

You: Add my new SwiftUI project FinanceTracker at ~/Developer/FinanceTracker
Claude: Successfully added… Detected tech stack: Swift Package Manager, SwiftUI

You: Update FinanceTracker status to 'Working on Core Data models'
Claude: Updated.

You: Which of my projects use Core Data or SwiftUI?
Claude: [search + roster]

You: Which projects need my attention?
Claude: [health report with scores and recommendations]

You: Show my activity this week
Claude: [heat map]

---

Requisitos previos

• macOS 13+
• Swift 6.0+ (Xcode 16+)
• Un host MCP: Claude Desktop, Cursor o Claude Code

Instalación

Compilar desde el código fuente

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator
swift build -c release

Ejecutable:

.build/release/project-coordinator

Claude Desktop

Configuración → Desarrollador → Model Context Protocol:

{
  "mcpServers": {
    "project-coordinator": {
      "command": "/absolute/path/to/Claude-Project-Coordinator/.build/release/project-coordinator",
      "args": []
    }
  }
}

Cursor

Agrega la misma entrada de servidor al JSON de configuración MCP de Cursor, usando la ruta absoluta a .build/release/project-coordinator.

Claude Code

Registra la misma ruta command en tu configuración MCP de Claude Code.

Opcional: establece CPC_KNOWLEDGE_BASE a un directorio de KnowledgeBase personalizado (útil si el clon es público y tu JSON de proyecto debe permanecer privado).

Reinicia el host después de cambiar la configuración.

---

Configuración de seguridad

Los valores predeterminados viven en Sources/ProjectCoordinator/SecurityValidator.swift (compilados).

Raíces permitidas: ~/Developer, ~/Documents, ~/GitHub, ~/Projects, ~/Desktop/Development, ~/Xcode

Límites: nombre de proyecto 100 · ruta 500 · descripción 2,000 · notas 10,000 · patrón de búsqueda 300 caracteres

Para cambiar listas blancas o límites, edita el código fuente, recompila (swift build -c release) y reinicia el host.

---

Estructura del proyecto

Claude-Project-Coordinator/
├── Sources/
│   ├── ProjectCoordinator/     # Library (MCP, manager, analytics, security)
│   └── project-coordinator/    # Executable entry point
├── Tests/ProjectCoordinatorTests/
├── KnowledgeBase/              # Patterns, templates, local project/analytics data
├── scripts/                    # Build and repair helpers
├── ANALYTICS-EXAMPLES.md       # Sample analytics output
├── Package.swift
└── README.md

---

Actualización desde v1.3.x

1. git pull y recompila con Swift 6: swift build -c release
2. Apunta tu host MCP al nuevo binario
3. Si las fechas de creación fueron corrompidas por el antiguo error de re-migración:

./scripts/repair-analytics-dates.sh

---

💖 Apoya este proyecto

Si CPC ha ayudado a optimizar tu flujo de trabajo de desarrollo o te ha ahorrado tiempo gestionando proyectos, considera apoyar su desarrollo:

Tu apoyo me ayuda a:

• Mantener y mejorar CPC con nuevas características
• Mantener el proyecto de código abierto y gratuito para todos
• Dedicar más tiempo a atender solicitudes de usuarios y correcciones de errores
• Explorar nuevas herramientas que mejoren la productividad de los desarrolladores

¡Gracias por considerar apoyar mi trabajo! 🙏

---

Contribuciones

Las contribuciones son bienvenidas. Reporta errores, sugiere características, abre pull requests o comparte patrones y plantillas en KnowledgeBase/.

Licencia

Licencia MIT.

Agradecimientos

Construido para el ecosistema MCP. Pila de protocolo: modelcontextprotocol/swift-sdk.

---

Hecho con ❤️ desde 🍍 Piña