dart-query

MCP-сервер для управления задачами Dart AI, оптимизированный для пакетных операций и минимального использования контекста.

Вместо того чтобы перебирать задачи по одной (заполняя окно контекста промежуточным JSON), dart-query использует селекторы DartQL и серверные пакетные операции для обновления сотен задач за один вызов. Обновление 50 задач, которое обычно потребляет ~30 тыс. токенов, занимает ~200 токенов без засорения контекста.

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

1. Получите ваш токен Dart AI

Посетите https://app.dartai.com/?settings=account и скопируйте свой токен (начинается с dsa_).

2. Настройте MCP

npx (рекомендуется)

{
  "mcpServers": {
    "dart-query": {
      "command": "npx",
      "args": ["-y", "@standardbeagle/dart-query"],
      "env": {
        "DART_TOKEN": "dsa_your_token_here"
      }
    }
  }
}

SLOP-MCP (v0.10.0+)

slop register dart-query \
  --command npx \
  --args "-y" "@standardbeagle/dart-query" \
  --env DART_TOKEN=dsa_your_token_here \
  --scope user

3. Проверка

info({ level: "overview" })

4. Пример: Пакетное обновление

// Preview first
batch_update_tasks({
  selector: "dartboard = 'Engineering' AND priority = 'high'",
  updates: { status: "Doing" },
  dry_run: true
})

// Execute
batch_update_tasks({
  selector: "dartboard = 'Engineering' AND priority = 'high'",
  updates: { status: "Doing" },
  dry_run: false
})

Инструменты

См. TOOLS.md для получения полных справочников параметров, синтаксиса DartQL и формата импорта CSV.

Селекторы DartQL

Синтаксис предложения WHERE в стиле SQL-92 для выбора задач при пакетных операциях:

dartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'
due_at < '2026-01-18' AND status <> 'Done'
title LIKE 'Task%'                          -- starts with
title LIKE '%auth%'                         -- contains substring

Операторы: =, !=, <>, >, >=, <, <=, LIKE, IN, NOT IN, BETWEEN, IS NULL, IS NOT NULL, CONTAINS Псевдонимы: INCLUDES/HAS → CONTAINS · <> → != Подстановочные знаки LIKE: % = любые символы, _ = один символ (регистронезависимо)

Безопасность

Все операции Dart AI выполняются в рабочей среде (без песочницы). dart-query предоставляет:

• Режим пробного запуска (dry-run) для всех пакетных операций — предварительный просмотр перед выполнением

• Этап проверки для импорта CSV — обнаружение ошибок до создания чего-либо

• Флаг подтверждения (confirm: true), обязательный для пакетного удаления

• Восстанавливаемое удаление — задачи перемещаются в корзину, а не удаляются безвозвратно

Лицензия

MIT