⚠️ AVISO DE REPOSITORIO PRIVADO ⚠️

Este es un repositorio privado exclusivo para los miembros del equipo de SimHop IT & Media AB. Si bien el código está disponible para su visualización y uso bajo la licencia MIT, por el momento no aceptamos contribuciones públicas. Puedes bifurcar el repositorio y crear tu propia versión, siempre que no sea idéntica ni muy similar a nuestro paquete para evitar confusiones entre los usuarios.

🤘 Avión Claudeus MCP 🎸

Libera el poder de la IA en tu reino de planos: ¡establece el estándar de excelencia en MCP! 🖤

🎯 Nuestra misión: mejorar la gestión de proyectos con IA

En el cambiante panorama de la gestión de proyectos basada en IA, presentamos Claudeus Plane MCP, un potente puente entre las capacidades de IA de Claude y la plataforma de gestión de proyectos de Plane. Nuestra misión es:

• ✅ Proporciona una integración perfecta de IA con Plane
• ✅ Habilitar flujos de trabajo automatizados de gestión de proyectos
• ✅ Mejore la colaboración en equipo mediante la asistencia de IA
• ✅ Agiliza la gestión de tareas y recursos
• ✅ Establecer nuevos estándares para el desarrollo de MCP

¿Por qué Claudeus Plane MCP?

Construido sobre la base de nuestro exitoso MCP Claudeus WordPress, este servidor ofrece el mismo nivel de:

• 🎸 Excelencia técnica: Cobertura completa de TypeScript con verificación de tipos estricta
• 🎸 Garantía de calidad: conjunto completo de pruebas (cobertura superior al 95 %)
• Cumplimiento del protocolo: Implementación completa de la especificación MCP 2024-11-05
• 🎸 Seguridad: Prácticas de seguridad de nivel empresarial
• 🎸 Confiabilidad: Manejo y recuperación de errores robustos
• 🎸 Documentación: Guías detalladas y ejemplos

🤘 Por qué elegimos Plane: The Technical Symphony

En el amplio panorama de soluciones de gestión de proyectos, elegir Plane no fue solo una decisión, sino una revelación técnica. Aquí explicamos por qué Plane destaca como la base perfecta para nuestra revolución en la gestión de proyectos impulsada por IA:

Excelencia técnica y arquitectura

1. Poder de código abierto
   • Transparencia total del código fuente
   • Licencia AGPL v3.0 que garantiza la libertad
   • Contribuciones activas de la comunidad
   • Capacidades de autohospedaje con Docker/Kubernetes
2. Pila de tecnología moderna
   • Construido con tecnologías de vanguardia
   • Arquitectura limpia y modular
   • Sistema de complementos extensible
   • Filosofía de diseño API-first
3. Rendimiento y escalabilidad
   • Tiempos de respuesta ultrarrápidos
   • Operaciones de base de datos eficientes
   • Mecanismos de almacenamiento en caché inteligentes
   • Soporte de escalamiento horizontal

🎯 Flexibilidad de funciones

A diferencia de las soluciones tradicionales que te obligan a seguir su flujo de trabajo:

⚡ Velocidad de desarrollo

La arquitectura de Plane permite:

• Iteración rápida : desarrollo e implementación rápidos de funciones
• Extensión fácil : desarrollo de complementos sencillos
• Excelencia API : Cobertura completa de API REST
• Actualizaciones en tiempo real : Compatibilidad con WebSockets para cambios en vivo

🔒 Seguridad y control

1. Soberanía de datos
   • Control total sobre la ubicación de los datos
   • Sin dependencia del proveedor
   • Políticas de seguridad personalizadas
   • Flexibilidad de cumplimiento
2. Autenticación y autorización
   • Sistema de permisos granulares
   • Múltiples métodos de autenticación
   • Control de acceso basado en roles
   • Gestión de claves API

💰 Rentabilidad

Arquitectura preparada para el futuro

El diseño del avión se alinea perfectamente con las necesidades de desarrollo modernas:

1. Listo para la integración de IA
   • Diseño de API limpio, perfecto para la integración de IA
   • Modelo de datos estructurado ideal para ML
   • Arquitectura extensible para funciones de IA
   • Capacidades en tiempo real para la asistencia de IA
2. Desarrollo moderno
   • Backend de TypeScript/Python
   • Frontend basado en React
   • Contenedorización de Docker
   • Orquestación de Kubernetes
3. Poder comunitario
   • Comunidad de desarrollo activa
   • Actualizaciones y mejoras periódicas
   • Abierto a contribuciones
   • Hoja de ruta transparente

🎸 El factor metal

Al igual que el heavy metal rompe con los límites musicales convencionales, Plane rompe con las restricciones tradicionales de gestión de proyectos:

• Libertad : Como escribir tus propios riffs en lugar de tocar covers.
• Poder : Control total sobre el destino de la gestión de sus proyectos
• Innovación : Capacidad de crear nuevos flujos de trabajo y funciones
• Comunidad : Fuerte espíritu de código abierto, al igual que la comunidad del metal.

🤘 "En un mundo de gestión de proyectos corporativos, Plane es como esa banda de metal underground que cambia las reglas del juego: ¡pura, potente y completamente auténtica!" - Amadeus

🔮 Potencial de asociación

La filosofía de Plane se alinea perfectamente con nuestra visión:

1. Excelencia en código abierto
   • Ambas empresas valoran la transparencia
   • Compromiso compartido con la calidad
   • Desarrollo impulsado por la comunidad
2. Enfoque en la innovación
   • Pensamiento centrado en la IA
   • Arquitectura moderna
   • Evolución continua
3. Sinergia técnica
   • Desarrollo impulsado por API
   • Pila de tecnología moderna
   • Enfoque en el rendimiento

Por eso, Plane no es solo nuestra elección: es nuestra alma gemela técnica en el ámbito de la gestión de proyectos. Junto con nuestra integración de IA a través de Claudeus Plane MCP, ¡creamos una sinfonía de eficiencia que revoluciona el mundo de la gestión de proyectos! 🤘

🚀 Características principales

🎯 Gestión de proyectos

• Crea y gestiona proyectos con asistencia de IA
• Configuración y configuración automatizadas del proyecto
• Plantillas y flujos de trabajo de proyectos inteligentes

📋 Gestión de tareas

• Creación y asignación de tareas impulsadas por IA
• Priorización automatizada de tareas
• Gestión inteligente de dependencias de tareas

👥 Colaboración en equipo

• Asignación inteligente de recursos
• Notificaciones automatizadas del equipo
• Equilibrio inteligente de la carga de trabajo

💬 Comunicación

• Gestión de comentarios mejorada con IA
• Sistemas de notificación inteligentes
• Actualizaciones de estado automatizadas

📖 Guía de inicio rápido

Prerrequisitos

Instalación

Configuración

Configuración de plane-instances.json

El archivo plane-instances.json se utiliza para configurar las instancias de Plane para la integración. A continuación, se muestra un ejemplo de estructura:

Campos de configuración

• baseUrl : La URL base de su API de avión (obligatorio)
• defaultWorkspace : El slug del espacio de trabajo predeterminado (obligatorio)
• otherWorkspaces : Matriz de slugs de espacios de trabajo adicionales (opcional)
• apiKey : su clave API de Plane (obligatoria)

🛠️ Desarrollo

Estructura del proyecto

Scripts disponibles

🔒 Seguridad

Autenticación

• Autenticación basada en clave API
• Gestión segura de tokens
• Validación de solicitud

Protección de datos

• Comunicación cifrada
• Almacenamiento seguro de configuración
• Sanitización de entrada

🤝 Contribuyendo

Este es un repositorio privado mantenido por el equipo de desarrollo de SimHop IT & Media AB. Si bien no aceptamos contribuciones públicas, los miembros del equipo pueden contribuir siguiendo nuestros estándares de desarrollo:

1. Crear ramas de características ( feature/AmazingFeature )
2. Mantener la cobertura de pruebas por encima del 95%
3. Siga nuestros estándares de TypeScript y documentación
4. Enviar solicitudes de relaciones públicas para su revisión

📄 Licencia

Licencia MIT - Copyright (c) 2024 SimHop IT & Media AB

🎸 El equipo detrás de la magia

SimHop IT & Media AB - Donde la innovación se fusiona con el metal 🤘

Con sede en Suecia, SimHop IT & Media AB aúna excelencia técnica e innovación creativa. Nuestro equipo está formado por:

Amadeus Samiel H. (CTO/Arquitecto principal de soluciones)

• Maestría en Ciencias de la Computación
• Más de 20 años de excelencia técnica
• El virtuoso detrás de los servidores MCP de Claudeus

Simon Malki (director ejecutivo)

• Más de 20 años de liderazgo empresarial
• Experto en planificación estratégica
• El visionario que impulsa el éxito de SimHop

Hecho con 🤘❤️ por Amadeus Samiel H.

🛠 Referencia de herramientas MCP

Categorías de herramientas y niveles de peligro

Leyenda del nivel de peligro

• 🟢 Seguro : Operaciones de solo lectura, sin modificación de datos
• 🟡 Moderado : Crea o modifica contenido, pero se puede revertir.
• 🔴 Alto : Operaciones destructivas o cambios en todo el sistema

🎯 Análisis técnico profundo

Descripción general de la arquitectura 🏗️

Cada componente de nuestra arquitectura técnica está diseñado para lograr la máxima eficiencia y confiabilidad:

Componentes principales 🤘

Implementación técnica 🎸

Medidas de seguridad 🛡️

Ajuste del rendimiento 🚀

Categorías de errores y manejo 🎸

Principios de diseño Power Chord 🤘

Consejo profesional: ¡Como una guitarra bien afinada, cada componente está calibrado con precisión para lograr la máxima capacidad de shredding! ❤️

⚡ Métricas de rendimiento

Ahorro de tiempo

Eficiencia de costos

🎸 Integración de escritorio de Claude

Ubicación de la configuración

El archivo de configuración de Claude Desktop se puede encontrar en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

⚠️ IMPORTANTE : Si ya tiene otros servidores MCP configurados en Claude Desktop, NO copie directamente nuestro archivo de ejemplo, ya que sobrescribirá su configuración actual. En su lugar:

1. Para los usuarios existentes de Claude Desktop :
   • Abra su configuración existente a través de Claude Desktop:
     • Haga clic en el menú de Claude
     • Seleccione "Configuración..."
     • Haga clic en "Desarrollador" en la barra de la izquierda.
     • Haga clic en "Editar configuración"
   • O abra su archivo de configuración directamente en un editor de texto
   • Agregue nuestra configuración de servidor Claudeus Plane MCP a su objeto mcpServers existente
2. Para nuevos usuarios de Claude Desktop : pueden copiar nuestro archivo de configuración de ejemplo:
   # For macOS cp claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json # For Windows (in PowerShell) Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json

Ejemplos de configuración

Configuración de NPX

Configuración de Docker 🐳

🎸 Consejo profesional: ¡Asegúrate de reemplazar /absolute/path/to/your/plane-instances.json con la ruta real a tu archivo de configuración!

Después de la configuración

1. Reiniciar Claude Desktop por completo
2. Busque el ícono del martillo 🔨 en la esquina inferior derecha del cuadro de entrada
3. Haga clic para ver las herramientas de gestión de aviones disponibles
4. ¡Empieza a triturar! 🤘

Solución de problemas

Si el servidor no aparece en Claude:

1. Verifique la sintaxis de claude_desktop_config.json
2. Asegúrese de que las rutas de archivo sean absolutas y válidas
3. Consulte los registros de Claude en:
   • macOS: ~/Library/Logs/Claude
   • Ventanas: %APPDATA%\Claude\logs

⚠️ Problemas y consideraciones

Limitaciones actuales y soluciones alternativas

1. Límites de respuesta de Claude Desktop

• Problema : La longitud máxima de respuesta de Claude Desktop se puede alcanzar durante operaciones complejas
• Impacto : Las operaciones pueden interrumpirse, lo que requiere la intervención del usuario.
• Solución alternativa :
  • Configurar Claude Desktop para dividir las tareas en lotes más pequeños
  • En Configuración de escritorio de Claude > Avanzado:
    • Establezca "Longitud máxima de respuesta" en un valor más bajo
    • Habilitar "Respuestas divididas automáticamente"
  • Utilice la interfaz de usuario del Inspector para operaciones a gran escala

2. Consideraciones sobre la limitación de velocidad

• Problema : La API de Plane tiene límites de velocidad
• Impacto : Las operaciones en masa podrían verse limitadas
• Mitigación :
  • Utilice las funciones de procesamiento por lotes
  • Implementar retrasos apropiados entre solicitudes
  • Supervisar los encabezados de respuesta de la API para obtener información sobre el límite de velocidad

3. Gestión de memoria

• Problema : Las operaciones grandes pueden consumir una cantidad significativa de memoria
• Impacto : Posible degradación del rendimiento
• Mejores prácticas :
  • Supervisar los recursos del sistema durante operaciones grandes
  • Utilice la paginación para conjuntos de datos grandes
  • Implementar rutinas de limpieza

Mejoras futuras

Estamos trabajando activamente en:

1. Manejo mejorado de respuestas en Claude Desktop
2. Gestión avanzada de limitación de velocidad
3. Técnicas de optimización de memoria
4. Mecanismos mejorados de recuperación de errores

🎸 Consejo profesional: ¡Consulta nuestras discusiones de GitHub para conocer soluciones alternativas y mejores prácticas!

🎸 Apoyo y Comunidad ❤️

• Discusiones de GitHub: comparta ideas, informe problemas y únase a la conversación
• Documentación: Documentación técnica completa
• Ejemplos: Implementaciones de muestra

Consejo profesional: utiliza las discusiones de GitHub para compartir tu experiencia, informar problemas o sugerir mejoras.

El himno del director de proyectos

por Amadeus y Claude

En el vasto espacio del avión,
Las tareas fluyen con gracia,
La adopción de la IA,
Establece un ritmo perfecto.

Por el poder de Claude,
Los proyectos toman vuelo,
En el deleite del código,
Todo sincroniza perfectamente.

El sueño de un gerente,
Donde la IA y el equipo,
Trabajar aguas arriba,
Como el brillo del metal.

Hecho con 🤘❤️ por Amadeus Samiel H.