Линейный MCP-сервер

Реализация сервера Model Context Protocol (MCP), обеспечивающая доступ к системе отслеживания проблем Linear через стандартизированный интерфейс.

Функции

• Создавайте новые выпуски и подвыпуски с поддержкой лейблов

• Получить список линейных проектов

• Получить обновления проекта

• Создать новое обновление проекта со статусом работоспособности

• Обновите существующие проблемы с полной модификацией поля

• Удалить проблему с проверкой

• Самостоятельно назначать проблемы, используя ключевое слово «я»

• Расширенный поиск с мощными возможностями фильтрации Linear

• Фильтрация проблем по циклу (текущий, следующий, предыдущий или определенный цикл по UUID или номеру)

• Добавляйте комментарии к проблемам с поддержкой разметки

• Запрос линейных проблем по идентификатору или ключу с дополнительными связями

• Поиск проблем с использованием пользовательских запросов с расширенными метаданными

• Типобезопасные операции с использованием официального SDK Linear

• Комплексная обработка ошибок

• Обработка ограничения скорости

• Чистое преобразование данных

• Отслеживание отношений родитель/потомок с наследованием команды

• Управление и синхронизация этикеток

Предпосылки

• Среда выполнения Bun (v1.0.0 или выше)

• Линейный аккаунт с доступом через API

Переменные среды

Установка и настройка

1. Клонируйте репозиторий:

2. Установите зависимости и соберите:

3. Настройте MCP-сервер:

Отредактируйте соответствующий файл конфигурации:

macOS:

• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Рабочий стол Клода: ~/Library/Application Support/Claude/claude_desktop_config.json

Окна:

• Cline: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

• Рабочий стол Клода: %APPDATA%\Claude Desktop\claude_desktop_config.json

Линукс:

• Клайн: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Claude Desktop: к сожалению, пока не существует

Добавьте следующую конфигурацию в объект mcpServers :

4. Перезапустите сервер MCP.

В настройках MCP Клайна перезапустите сервер MCP. Перезапустите Claude Desktop, чтобы загрузить новый сервер MCP.

Разработка

Запустить сервер разработки:

Проект сборки:

Доступные инструменты MCP

Подробные примеры использования всех инструментов см. на USAGE.md .

создать_выпуск

Создайте новый линейный выпуск или подвыпуск.

Схема ввода:

обновление_выпуск

Обновите существующую линейную проблему.

Схема ввода:

получить_выпуск

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

Схема ввода:

поисковые_вопросы

Поиск проблем Linear с использованием строки запроса и расширенных фильтров. Поддерживает мощные возможности фильтрации Linear.

Схема ввода:

Поддерживаемые компараторы:

• Строковые поля: eq , neq , in , nin , contains , startsWith , endsWith (плюс варианты без учета регистра)

• Числовые поля: eq , neq , lt , lte , gt , gte , in , nin

• Поля даты: eq , neq , lt , lte , gt , gte (поддерживает длительность ISO 8601)

получить_команды

Получите список линейных команд с дополнительной фильтрацией по имени/ключу.

Схема ввода:

удалить_выпуск

Удалить существующую линейную проблему.

Схема ввода:

создать_комментарий

Создайте новый комментарий к линейной проблеме.

Схема ввода:

получить_проекты

Получите список линейных проектов с дополнительной фильтрацией по имени и разбиением на страницы.

Схема ввода:

получить_обновления_проекта

Получайте обновления проекта для указанного идентификатора проекта с дополнительными параметрами фильтрации.

Схема ввода:

создать_проект_обновить

Создайте новое обновление для линейного проекта.

Схема ввода:

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

• Создано с помощью TypeScript в строгом режиме

• Использует официальный SDK Linear (@linear/sdk)

• Использует MCP SDK (@modelcontextprotocol/sdk 1.4.0)

• Аутентификация через API-токены

• Комплексная обработка ошибок

• Соображения по ограничению скорости

• Bun runtime для повышения производительности

• Модули ESM по всему

• Система сборки Vite

• Типобезопасные операции

• Возможности очистки данных:

  • Извлечение упоминаний о проблеме (формат ABC-123)

  • Извлечение упоминаний пользователя (формат @имя пользователя)

  • Очистка содержимого Markdown

  • Оптимизация контента для контекста ИИ

• Поддержка самостоятельного назначения:

  • Автоматическое разрешение текущего пользователя

  • Поддержка ключевого слова «me» в операциях создания/обновления

  • Эффективное кэширование идентификаторов пользователей

• Расширенные возможности поиска:

  • Комплексная фильтрация с помощью API Linear

  • Поддержка всех полевых компараторов

  • Фильтрация отношений

  • Логические операторы (и, или)

  • Фильтрация по относительной дате

  • Фильтр по правообладателю/создателю (включая себя)

  • Поддержка определенных идентификаторов пользователей

  • Фильтрация проектов по идентификатору или названию

  • Эффективная оптимизация запросов

• Возможности управления проектами:

  • Список проектов с фильтрацией и пагинацией

  • Создание обновлений проекта с отслеживанием состояния работоспособности

  • Извлечение обновлений проекта с возможностью фильтрации

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

Сервер реализует комплексную стратегию обработки ошибок:

• Обнаружение сетевых ошибок и отправка соответствующих сообщений

• Обработка кода статуса HTTP

• Подробные сообщения об ошибках с кодами состояния

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

• Проверка ввода всех параметров

• Проверка и синхронизация этикеток

• Безопасное распространение ошибок через протокол MCP

• Обнаружение и обработка ограничений скорости

• Обработка ошибок аутентификации

• Неверная обработка запроса

• Проверка наследования команды для подзадач

• Проверка разрешения пользователя

• Проверка фильтра поиска

ЛИЦЕНЗИЯ

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENCE .