Linear MCP Integration Server

Servidor de integración MCP lineal

Este servidor proporciona capacidades de integración con Linear mediante el Protocolo de Contexto de Modelo (MCP). Permite que los modelos de IA interactúen con Linear para el seguimiento de problemas y la gestión de proyectos.

Características

El servidor proporciona las siguientes herramientas a través de la interfaz MCP:

problema de creación lineal

Crea un nuevo problema lineal con los siguientes parámetros:

• title (obligatorio): Título del problema
• teamId (obligatorio): ID del equipo para crear el problema
• description (opcional): Descripción del problema (compatible con Markdown)
• priority (opcional): Nivel de prioridad (0-4)
• status (opcional): Nombre del estado inicial

problemas de búsqueda lineal

Búsqueda de problemas lineales con filtrado flexible y soporte de paginación:

• query (opcional): Texto a buscar en el título/descripción
• teamId (opcional): Filtrar por equipo
• status (opcional): Filtrar por estado
• assigneeId (opcional): Filtrar por cesionario
• priority (opcional): Nivel de prioridad (0-4)
• limit (opcional, predeterminado: 10): Máximo de resultados por página
• cursor (opcional): cursor de paginación para buscar la página siguiente
• sortBy (opcional, predeterminado: 'actualizado'): Campo por el que ordenar ('creado', 'actualizado', 'prioridad', 'título')
• sortDirection (opcional, predeterminado: 'desc'): Dirección de ordenamiento ('asc', 'desc')

Problemas de sprint lineal

Obtener todos los problemas en el sprint/iteración actual:

• teamId (obligatorio): ID del equipo para obtener los problemas del sprint

equipos de búsqueda lineal

Buscar y recuperar equipos lineales:

• query (opcional): Texto para buscar en los nombres de los equipos

Problemas de sprint con filtros lineales

Filtra los problemas de sprint actuales por estado y filtra automáticamente al usuario actual:

• teamId (obligatorio): ID del equipo para obtener los problemas del sprint
• status (obligatorio): Estado por el que se filtrará (p. ej., "Pendiente de lanzamiento de producto")

obtener_detalles_del_problema_lineal

Obtenga información detallada sobre un problema específico, incluida una descripción completa, comentarios y metadatos:

• issueId (obligatorio): ID del problema (por ejemplo, "DATA-1284") para obtener detalles

estado de actualización masiva lineal

Actualizar el estado de varios problemas lineales a la vez:

• issueIds (obligatorio): Lista de ID de problemas para actualizar (por ejemplo, ["ENG-123", "DATA-456"])
• targetStatus (obligatorio): Estado objetivo que se establecerá para todos los problemas (por ejemplo, "En progreso")

ciclo de gestión lineal

Crear, actualizar u obtener información sobre ciclos lineales (sprints):

• action (obligatoria): Acción a realizar: "crear", "actualizar", "obtener" o "enumerar"
• teamId (obligatorio): ID del equipo para administrar los ciclos
• cycleId (opcional, necesario para acciones de actualización y obtención): ID de ciclo
• name (opcional, requerido para crear): Nombre del ciclo
• startDate (opcional, necesario para la creación): Fecha de inicio en formato ISO (AAAA-MM-DD)
• endDate (opcional, obligatorio para la creación): Fecha de finalización en formato ISO (AAAA-MM-DD)
• description (opcional): Descripción del ciclo

Configuración del desarrollador

1. Obtén tu clave API de Linear desde la sección API de configuración de Linear
2. Cree un archivo .env en la raíz del proyecto:

3. Instalar dependencias:

4. Iniciar el servidor:

Detalles técnicos

• Desarrollado con TypeScript y el SDK del protocolo de contexto de modelo
• Utiliza el SDK lineal para interacciones de API
• Incluye manejo de errores, limitación de velocidad y administración de conexión.
• Admite la reconexión automática con reintentos configurables
• Implementa el monitoreo de latidos para la salud de la conexión
• Proporciona un registro detallado en modo de depuración
• Cuenta con un sistema de almacenamiento en caché en memoria para un mejor rendimiento.
• Admite paginación para gestionar grandes conjuntos de resultados
• Implementa el procesamiento por lotes para operaciones masivas

Rendimiento y confiabilidad

El servidor incluye características integrales para el rendimiento y la confiabilidad:

Sistema de almacenamiento en caché

• Almacenamiento en caché en memoria para datos a los que se accede con frecuencia (equipos, estados de flujo de trabajo)
• TTL (tiempo de vida) configurable para entradas de caché
• Limpieza automática de entradas de caché caducadas
• Estadísticas de caché disponibles en modo de depuración

Manejo de errores

• Protección de tiempo de espera de API con tiempos de espera configurables
• Intentos de reconexión automática en caso de pérdida de conexión
• Registro detallado de errores con marcas de tiempo y contexto
• Manejo elegante del apagado con limpieza
• Monitoreo del ritmo cardíaco para la salud de la conexión

Optimizaciones de rendimiento

• Procesamiento por lotes para operaciones a gran escala
• Compatibilidad con paginación para grandes conjuntos de resultados
• Procesamiento paralelo con Promise.all para operaciones concurrentes
• Obtención eficiente de datos con mínimas llamadas a la API

Dependencias

• @linear/sdk : Cliente de API lineal
• @modelcontextprotocol/sdk : Implementación del servidor MCP
• zod : Comprobación y validación de tipos en tiempo de ejecución
• dotenv : Gestión de variables de entorno
• TypeScript y herramientas de desarrollo relacionadas

Para obtener la lista completa de dependencias, consulte package.json .

Despliegue de herrería

Este servidor se puede implementar en Smithery.ai utilizando los archivos de configuración proporcionados:

Prerrequisitos

• Una cuenta de Smithery.ai
• Su clave API lineal

Pasos de implementación

1. Agregue este repositorio a Smithery o reclame un servidor existente
2. Acceda a la pestaña Implementaciones (solo propietarios autenticados)
3. Configurar la implementación con su clave API lineal
4. Implementar el servidor

Archivos de configuración

El repositorio incluye dos archivos esenciales para la implementación de Smithery:

1. Dockerfile : define el proceso de compilación del servidor
   • Utiliza Node.js 18 Alpine como imagen base
   • Instala dependencias y compila el código TypeScript
   • Configura el comando para ejecutar el servidor
2. smithery.yaml : define la configuración de inicio del servidor
   • Especifica el comando para ejecutar el servidor
   • Define los parámetros de configuración necesarios (clave API lineal)
   • Maneja la configuración de variables de entorno

Pruebas locales

Puede probar la configuración de Smithery localmente usando el Inspector MCP: