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

Buscar problemas lineales con filtrado flexible:

• 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 a devolver

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")

obtención lineal de estados de flujo de trabajo

Obtener todos los estados de flujo de trabajo disponibles (estados) para un equipo:

• teamId (obligatorio): ID del equipo para obtener los estados del flujo de trabajo

proyectos de lista lineal

Obtenga una lista de todos los proyectos disponibles con sus ID:

• teamId (opcional): ID del equipo para filtrar proyectos por equipo
• limit (opcional, predeterminado: 50): número máximo de proyectos a devolver

Configuración del desarrollador

1. Obtén tu clave API de Linear desde la sección API de configuración de Linear
2. Copie el archivo de ejemplo de medio ambiente:
   cp .env.example .env
3. Modifique el archivo .env y agregue su clave API Linear :
   LINEAR_API_KEY=votre_clé_api_linear_ici
4. Instalar dependencias:
   npm install
5. Iniciar el servidor:
   # Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect

Configuración de Docker si el proyecto se clonó desde GitHub

También puedes ejecutar esta aplicación usando Docker:

1. Asegúrese de tener Docker y Docker Compose instalados en su sistema
2. Cree un archivo .env con su clave API lineal como se describe arriba
3. Construya e inicie el contenedor:
   # Build and start the container in detached mode docker-compose up -d # View logs docker-compose logs -f # Stop the container docker-compose down
4. El servidor se ejecutará dentro del contenedor y se reiniciará automáticamente a menos que se detenga explícitamente.

Uso de Docker (método simplificado con docker-compose)

1. Cree un archivo .env con su clave API lineal:
   LINEAR_API_KEY=your_linear_api_key_here
2. Cree un archivo docker-compose.yml :
   version: '3.8' services: mcp-linear-server: image: madebynando/mcp-linear-server:latest container_name: mcp-linear-server restart: unless-stopped env_file: - .env volumes: - ./logs:/app/logs
3. Iniciar el contenedor:
   docker-compose up -d
4. Para configurar el cursor, utilice:
   • Tipo de transporte: comando
   • Comando: docker exec -i mcp-linear-server node dist/server.js

Desarrollo de Docker

Para el desarrollo con Docker:

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

Manejo de errores

El servidor incluye un manejo integral de errores:

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

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 .

Uso en el cursor

Para utilizar este servidor en Cursor, puedes agregarlo como servidor MCP.

Sin Docker

Advertencia: Asegúrese de configurar LINEAR_API_KEY directamente en el comando al agregar el servidor MCP en Cursor. Esto es crucial para que el servidor se autentique e interactúe correctamente con la API Linear. De lo contrario, se producirán errores de autenticación y el servidor no funcionará correctamente.

Ejemplo:

env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js

1. Abra el menú de configuración del cursor
2. Vaya a la sección "Servidores MCP"
3. Haga clic en "Agregar servidor MCP"
4. Introduzca los siguientes datos:
   • Nombre: servidor-mcp-lineal
   • Tipo de transporte: comando
   • Comando: env LINEAR_API_KEY=your_linear_api_key nodo /ruta/a/su/servidor-lineal-mcp/dist/server.js
5. Haga clic en "Guardar"
6. Ahora debería ver la herramienta Lineal en la lista de herramientas del Cursor.

Con Docker

1. Abra el menú de configuración del cursor
2. Vaya a la sección "Servidores MCP"
3. Haga clic en "Agregar servidor MCP"
4. Introduzca los siguientes datos:
   • Nombre: servidor-mcp-lineal
   • Tipo de transporte: comando
   • Comando: docker exec -i mcp-linear-server node dist/server.js
5. Haga clic en "Guardar"
6. Ahora debería ver la herramienta Lineal en la lista de herramientas del Cursor.

Instruyendo a Claude

Al indicarle a Claude que utilice este servidor MCP, puede hacer referencia a los siguientes puntos finales:

Cree un nuevo problema lineal con título, descripción, ID de equipo, prioridad y estado.

Busque problemas lineales con filtrado flexible por consulta, equipo, estado, asignado, prioridad y límite.

Obtener todos los problemas en el sprint/iteración actual para un equipo específico.

Busque y recupere equipos lineales por nombre.

Filtrar los problemas de sprint actuales por estado para un equipo específico.

Obtenga todos los estados de flujo de trabajo disponibles (estados) para un equipo específico.

Obtenga una lista de todos los proyectos disponibles con sus ID, opcionalmente filtrados por equipo.