Agile Luminary

Conecta clientes de IA al sistema de gestión de proyectos Agile Luminary a través de su API REST.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Agile Luminary

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que conecta clientes de IA (como Cursor o Claude Desktop) al sistema de gestión de proyectos Agile Luminary alojado en https://agileluminary.com.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es una forma estandarizada para que las aplicaciones de IA se conecten a fuentes de datos y servicios externos. Este servidor actúa como un puente entre tu cliente de IA y la API REST de Agile Luminary, permitiéndote recuperar detalles de proyectos, asignaciones de trabajo y documentación directamente en tus conversaciones de IA.

Arquitectura

AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)

Características

Este servidor MCP proporciona tres herramientas principales que obtienen datos de la API de Agile Luminary:

📚 getRelatedDocuments

  • Propósito: Recuperar documentos relacionados basados en una cadena de búsqueda
  • Parámetros: searchString (obligatorio) - El texto a buscar en los documentos
  • Caso de uso: Encuentra documentación y especificaciones relevantes relacionadas con tu trabajo actual

📋 getCurrentWork

  • Propósito: Obtiene el trabajo actualmente asignado al usuario
  • Parámetros: Ninguno
  • Caso de uso: Consulta qué tareas e historias de usuario están asignadas activamente a ti

🔍 getPastWork

  • Propósito: Recupera trabajo completado relacionado con historias de usuario según criterios de búsqueda
  • Parámetros: searchString (obligatorio) - Término de búsqueda para encontrar trabajo pasado relevante
  • Caso de uso: Revisa el contexto histórico y las tareas completadas para una mejor toma de decisiones

Instalación y Configuración

Requisitos previos

  • Node.js (v16 o superior)
  • Un cliente de IA que soporte MCP (Cursor IDE, Claude Desktop, etc.)

Instalar dependencias

npm install @modelcontextprotocol/sdk zod

Variables de entorno

Configura tu clave de API como una variable de entorno:

export LUMINARY_API_KEY=your_api_key_here

Ejecutar el servidor

node server.js

El servidor se iniciará y escuchará conexiones de tu cliente de IA a través del transporte stdio.

Configuración

Para Cursor IDE

Añade esto a tu configuración de MCP:

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Para Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Ejemplos de uso

Una vez conectado, puedes usar lenguaje natural en tu cliente de IA:

  • "Buscar documentos sobre autenticación"
  • "Muéstrame mis asignaciones de trabajo actuales"
  • "Encontrar trabajo pasado relacionado con la funcionalidad de inicio de sesión de usuarios"
  • "¿Qué documentación existe sobre el sistema de pagos?"
  • "Basado en mi trabajo actual, ¿qué tareas similares se completaron antes?"

Endpoints de la API

El servidor se conecta a los siguientes endpoints de la API de Agile Luminary:

  • POST http://localhost:5006/bend/mcp/documents/search - Buscar documentos
  • GET http://localhost:5006/bend/mcp/userstories/current - Obtener trabajo actual
  • POST http://localhost:5006/bend/mcp/userstories/search - Buscar trabajo pasado

Beneficios

  • Datos en tiempo real: Obtén siempre la información más reciente del proyecto desde tu sistema desplegado
  • IA consciente del contexto: Tu asistente de IA tiene contexto completo del estado de tu proyecto y documentación
  • Integración perfecta: Funciona directamente dentro de tu entorno de desarrollo
  • Seguro: El servidor maneja la autenticación y comunicación con la API localmente
  • Capacidades de búsqueda: Encuentra documentos relevantes y trabajo pasado mediante búsqueda inteligente

Autenticación

El servidor utiliza la variable de entorno LUMINARY_API_KEY para la autenticación. Esta clave se pasa en el encabezado Authorization para todas las solicitudes a la API. Asegúrate de configurar esta variable de entorno antes de ejecutar el servidor.

Manejo de errores

El servidor incluye manejo integral de errores para:

  • Problemas de conectividad de red
  • Fallos de autenticación de la API
  • Respuestas malformadas
  • Indisponibilidad del servicio
  • Claves de API faltantes

Contribuciones

Este servidor MCP está diseñado para funcionar específicamente con el sistema de gestión de proyectos Agile Luminary. Para modificaciones o mejoras, asegura la compatibilidad con los endpoints de la API existentes.

Nota: Asegúrate de que tu cuenta de Agile Luminary esté creada y tengas tu clave de API de https://agileluminary.com antes de usar este servidor MCP. Configura la variable de entorno LUMINARY_API_KEY con tu clave de API.