Линейный сервер интеграции MCP

Этот сервер обеспечивает возможности интеграции Linear через Model Context Protocol (MCP). Он позволяет моделям ИИ взаимодействовать с Linear для отслеживания проблем и управления проектами.

Функции

Сервер предоставляет следующие инструменты через интерфейс MCP:

linear_create_issue

Создает новую линейную задачу со следующими параметрами:

• title (обязательно): Название выпуска

• teamId (обязательно): идентификатор команды для создания проблемы

• description (необязательно): Описание проблемы (поддерживается разметка)

• priority (необязательно): уровень приоритета (0-4)

• status (необязательно): Имя начального статуса

линейный_поиск_вопросы

Поиск линейных проблем с гибкой фильтрацией и поддержкой пагинации:

• query (необязательно): Текст для поиска в заголовке/описании

• teamId (необязательно): Фильтр по команде

• status (необязательно): Фильтр по статусу

• assigneeId (необязательно): Фильтр по назначению

• priority (необязательно): уровень приоритета (0-4)

• limit (необязательно, по умолчанию: 10): Максимальное количество результатов на страницу

• cursor (необязательно): Курсор пагинации для извлечения следующей страницы

• sortBy (необязательно, по умолчанию: «обновлено»): поле для сортировки («создано», «обновлено», «приоритет», «название»).

• sortDirection (необязательно, по умолчанию: 'desc'): Направление сортировки ('asc', 'desc')

линейный_спринт_проблемы

Получить все проблемы в текущем спринте/итерации:

• teamId (обязательно): идентификатор команды для получения задач спринта

линейные_поисковые_команды

Поиск и извлечение линейных команд:

• query (необязательно): Текст для поиска в названиях команд

линейный_фильтр_спринт_проблемы

Фильтровать текущие задачи спринта по статусу и автоматически фильтровать по текущему пользователю:

• teamId (обязательно): идентификатор команды для получения задач спринта

• status (обязательно): статус для фильтрации (например, «Ожидает выпуска продукта»)

linear_get_issue_details

Получите подробную информацию о конкретной проблеме, включая полное описание, комментарии и метаданные:

• issueId (обязательно): идентификатор проблемы (например, «DATA-1284») для получения сведений

линейное_массовое_обновление_статуса

Обновите статус нескольких линейных проблем одновременно:

• issueIds (обязательно): список идентификаторов проблем для обновления (например, ["ENG-123", "DATA-456"])

• targetStatus (обязательно): целевой статус, устанавливаемый для всех задач (например, «В процессе»)

линейное_управление_циклом

Создать, обновить или получить информацию о линейных циклах (спринтах):

• action (обязательно): Действие для выполнения: «создать», «обновить», «получить» или «список»

• teamId (обязательно): идентификатор команды для управления циклами

• cycleId (необязательно, требуется для действий обновления и получения): идентификатор цикла

• name (необязательно, требуется для создания): Имя цикла

• startDate (необязательно, требуется для создания): Дата начала в формате ISO (ГГГГ-ММ-ДД)

• endDate (необязательно, требуется для создания): дата окончания в формате ISO (ГГГГ-ММ-ДД)

• description (необязательно): Описание цикла

Related MCP server: Linear MCP Server

Настройка разработчика

1. Получите свой ключ API Linear в разделе настроек Linear > API.

2. Создайте файл .env в корне проекта:

LINEAR_API_KEY=your_api_key_here

3. Установить зависимости:

npm install

4. Запустите сервер:

# 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

Технические подробности

• Создано с помощью TypeScript и SDK Model Context Protocol

• Использует Linear SDK для взаимодействия с API

• Включает обработку ошибок, ограничение скорости и управление соединениями.

• Поддерживает автоматическое повторное подключение с настраиваемыми попытками повтора

• Реализует мониторинг сердцебиения для проверки работоспособности соединения

• Обеспечивает подробное ведение журнала в режиме отладки

• Имеет систему кэширования в памяти для повышения производительности

• Поддерживает разбиение на страницы для обработки больших наборов результатов.

• Реализует пакетную обработку для массовых операций

Производительность и надежность

Сервер включает в себя комплекс функций для повышения производительности и надежности:

Система кэширования

• Кэширование в памяти для часто используемых данных (команды, состояния рабочего процесса)

• Настраиваемый TTL (время жизни) для записей кэша

• Автоматическая очистка устаревших записей кэша

• Статистика кэша доступна в режиме отладки

Обработка ошибок

• Защита от тайм-аутов API с настраиваемыми тайм-аутами

• Автоматические попытки повторного подключения при потере соединения

• Подробная регистрация ошибок с временными метками и контекстом

• Плавное завершение работы с очисткой

• Мониторинг сердцебиения для определения состояния соединения

Оптимизация производительности

• Пакетная обработка для массовых операций

• Поддержка пагинации для больших наборов результатов

• Параллельная обработка с Promise.all для одновременных операций

• Эффективная выборка данных с минимальным количеством вызовов API

Зависимости

• @linear/sdk : Линейный клиент API

• @modelcontextprotocol/sdk : реализация сервера MCP

• zod : Проверка и валидация типов во время выполнения

• dotenv : Управление переменными среды

• TypeScript и связанные с ним инструменты разработки

Полный список зависимостей см. в package.json .

Развертывание кузницы

Этот сервер можно развернуть на Smithery.ai , используя предоставленные файлы конфигурации:

Предпосылки

• Аккаунт Smithery.ai

• Ваш линейный ключ API

Этапы развертывания

1. Добавьте этот репозиторий в Smithery или заявите права на существующий сервер

2. Доступ к вкладке «Развертывания» (только для аутентифицированных владельцев)

3. Настройте развертывание с помощью вашего ключа линейного API.

4. Развертывание сервера

Файлы конфигурации

Репозиторий включает два основных файла для развертывания Smithery:

1. Dockerfile : определяет процесс сборки сервера.

   • Использует Node.js 18 Alpine в качестве базового образа

   • Устанавливает зависимости и собирает код TypeScript

   • Настраивает команду для запуска сервера

2. smithery.yaml : определяет конфигурацию запуска сервера

   • Указывает команду для запуска сервера

   • Определяет требуемые параметры конфигурации (линейный ключ API)

   • Управляет настройкой переменных среды

Тестирование локально

Вы можете протестировать конфигурацию Smithery локально с помощью MCP Inspector:

# Build the Docker image
docker build -t linear-mcp-server .

# Run the container with your Linear API key
docker run -e LINEAR_API_KEY=your_api_key_here linear-mcp-server

# Or use the MCP Inspector
npm run inspect