youtrack-mcp

Сервер MCP для YouTrack, созданный с использованием TypeScript и Bun. Он работает с любым экземпляром YouTrack (облачным или размещённым на собственном сервере) — вы предоставляете базовый URL и API-токен, ничего не захардкожено.

Настройка

Вам нужен постоянный токен YouTrack: в YouTrack перейдите в свой профиль → Безопасность аккаунта → Новый токен....

Задайте две переменные окружения:

• YOUTRACK_BASE_URL — базовый URL REST API вашего экземпляра, например https://mycompany.youtrack.cloud/api или https://youtrack.mycompany.com/api для установок на собственном сервере.

• YOUTRACK_TOKEN — постоянный токен.

Установите зависимости с помощью Bun:

bun install

Запуск напрямую

YOUTRACK_BASE_URL=https://mycompany.youtrack.cloud/api YOUTRACK_TOKEN=perm:xxxx bun run src/index.ts

Настройка в MCP-клиенте

Например, в mcp.json для Claude Code / Claude Desktop:

{
  "mcpServers": {
    "youtrack": {
      "command": "bun",
      "args": ["run", "/path/to/youtrack-mcp/src/index.ts"],
      "env": {
        "YOUTRACK_BASE_URL": "https://mycompany.youtrack.cloud/api",
        "YOUTRACK_TOKEN": "perm:xxxx"
      }
    }
  }
}

Related MCP server: YouTrack MCP

Инструменты

Инструменты сгруппированы по ресурсам и используют общий аргумент fields (синтаксис частичного ответа YouTrack) с разумным значением по умолчанию, так что вам нужно указывать его только тогда, когда вы хотите получить больше или меньше данных.

• Задачи — list_issues (поиск), get_issue, create_issue, update_issue, delete_issue, execute_command (применяет любую команду YouTrack — статус, исполнитель, приоритет, ссылки, теги, спринт и т.д. через его естественный синтаксис запросов, например "State Fixed assignee John.Doe")

• Комментарии — list_issue_comments, add_issue_comment, update_issue_comment, delete_issue_comment

• Ссылки — list_issue_links, list_issue_link_types

• Теги — list_tags, create_tag, list_issue_tags, add_issue_tag, remove_issue_tag

• Учёт времени — list_issue_work_items, add_issue_work_item, update_issue_work_item, delete_issue_work_item, list_work_items

• Проекты — list_projects, get_project, create_project, update_project, list_project_custom_fields

• Пользователи и группы — get_current_user, list_users, get_user, list_groups

• База знаний — list_articles, get_article, create_article, update_article, delete_article

• Agile-доски — list_agile_boards, get_agile_board, list_sprints, get_sprint

• Сохранённые поиски — list_saved_queries

• Запасной выход — youtrack_raw_request вызывает любой эндпоинт YouTrack REST API напрямую (метод, путь, запрос, тело), для длинного хвоста административных/настроечных эндпоинтов, не покрытых отдельным инструментом.

Архитектура

• src/youtrack/client.ts — единственное место, которое работает с HTTP: заголовок авторизации, построение URL/запросов, обработка JSON и ошибок. Каждый инструмент проходит через него.

• src/youtrack/fields.ts — предустановленные значения fields для каждой сущности, взятые из собственных значений OpenAPI YouTrack.

• src/youtrack/params.ts — общие фрагменты схемы Zod (fields, пагинация, ID), используемые повторно в инструментах.

• src/tool.ts — defineTool + registerTools, так что каждый файл инструмента объявляет только имя/описание/схему/обработчик, а обёртка ответа/ошибки MCP происходит в одном месте.

• src/youtrack/tools/*.ts — один файл на ресурс, каждый инструмент — несколько строк, построенных на общих компонентах выше.

Разработка

bun run typecheck   # tsc --noEmit
bun run dev         # run with --watch