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

Примечание: Это пользовательская реализация. Для официального сервера Cline Linear MCP см. cline/linear-mcp .

Сервер протокола контекста модели (MCP), предоставляющий инструменты для взаимодействия с API Linear, позволяя агентам ИИ управлять проблемами, проектами и командами программным способом через платформу Linear.

Функции

Управление проблемами
- Создавайте новые задачи с настраиваемыми свойствами (название, описание, команда, ответственный, приоритет, метки)
- Список проблем с гибкими возможностями фильтрации (команда, ответственный, статус)
- Обновить существующие проблемы (название, описание, статус, ответственный, приоритет)
Управление командой
- Список всех команд в рабочей области
- Доступ к данным команды, включая идентификатор, имя, ключ и описание.
Управление проектом
- Список всех проектов с возможностью фильтрации по команде
- Просмотр сведений о проекте, включая название, описание, состояние и связанные команды.

Предпосылки

Node.js (v16 или выше)
Линейный аккаунт с доступом к API
Линейный API-ключ с соответствующими разрешениями

Быстрый старт

Получите свой ключ API Linear в настройках разработчика Linear
Запустите с вашим ключом API:

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Или установите его в своей среде:

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

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

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

git clone [repository-url]
cd linear-mcp

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

npm install

Создайте проект:

npm run build

Бег с инспектором

Для локальной разработки и отладки вы можете использовать MCP Inspector:

Установить супершлюз:

npm install -g supergateway

Используйте прилагаемый скрипт run.sh :

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

Доступ к инспектору:
- Откройте localhost:1337 в вашем браузере.
- Инспектор подключается через отправленные сервером события (SSE)
- Тестирование и отладка вызовов инструментов через интерфейс Inspector

Конфигурация

Настройте сервер MCP в файле настроек в зависимости от вашего клиента:

Для рабочего стола Клода

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Для расширения VS Code (Cline)

Расположение: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Для курсора ( cursor.sh )

Для Cursor сервер должен быть запущен с полным путем:

node /Users/ibraheem/Projects/linear-mcp/build/index.js

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

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

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

{
  title: string;          // Required: Issue title
  description?: string;   // Optional: Issue description (markdown supported)
  teamId: string;        // Required: Team ID
  assigneeId?: string;   // Optional: Assignee user ID
  priority?: number;     // Optional: Priority (0-4)
  labels?: string[];     // Optional: Label IDs to apply
}

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

Перечисляет проблемы с дополнительными фильтрами.

{
  teamId?: string;      // Optional: Filter by team ID
  assigneeId?: string;  // Optional: Filter by assignee ID
  status?: string;      // Optional: Filter by status
  first?: number;       // Optional: Number of issues to return (default: 50)
}

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

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

{
  issueId: string;       // Required: Issue ID
  title?: string;        // Optional: New title
  description?: string;  // Optional: New description
  status?: string;      // Optional: New status
  assigneeId?: string;  // Optional: New assignee ID
  priority?: number;    // Optional: New priority (0-4)
  labels?: string[];   // Optional: Label IDs to apply to the issue
}

список_команд

Список всех команд в рабочей области. Параметры не требуются.

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

Список всех проектов с возможностью фильтрации.

{
  teamId?: string;     // Optional: Filter by team ID
  first?: number;      // Optional: Number of projects to return (default: 50)
}

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

Получает подробную информацию о конкретной проблеме.

{
  issueId: string; // Required: Issue ID
}

Разработка

Для разработки с автоматической пересборкой:

npm run watch

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

Сервер включает в себя комплексную обработку ошибок для:

Недействительные ключи API
Отсутствуют обязательные параметры
Ошибки линейного API
Недействительные запросы на инструменты

Все ошибки правильно отформатированы и сопровождаются описательными сообщениями.

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

Построено с:

Машинопись
Линейный SDK (@linear/sdk v37.0.0)
MCP SDK (@modelcontextprotocol/sdk v0.6.0)

Сервер использует stdio для связи и реализует протокол контекста модели для бесшовной интеграции с агентами ИИ.

Лицензия

Массачусетский технологический институт

Linear MCP Server

Integrations