dart-query

dart-query

バッチ操作とコンテキスト使用量の最小化に最適化された、Dart AI のタスク管理用 MCP サーバーです。

タスクを1件ずつループ処理してコンテキストウィンドウを中間 JSON で埋める代わりに、dart-query は DartQL セレクターとサーバー側のバッチ操作を使用して、1回の呼び出しで数百件のタスクを更新します。通常なら約30Kトークンを消費する50件のタスクの更新も、コンテキストの劣化なしで約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
})

ツール

グループ	ツール	目的
検出	info、get_config	機能とワークスペース設定を確認する
タスク CRUD	create_task、get_task、update_task、delete_task、add_task_comment	単一タスクの操作
クエリ	list_tasks、search_tasks	フィルターまたは全文検索でタスクを検索する
バッチ	batch_update_tasks、batch_delete_tasks、get_batch_status	DartQL セレクターによる一括操作
インポート	import_tasks_csv	検証付きで CSV から一括作成する
ドキュメント	list_docs、create_doc、get_doc、update_doc、delete_doc	ドキュメント管理

パラメーターの詳細、DartQL 構文、CSV インポート形式については、TOOLS.md を参照してください。

DartQL セレクター

バッチ操作で対象のタスクを指定するための SQL-92 WHERE 句構文です。

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 のワイルドカード： % = 任意の文字列、_ = 任意の1文字（大文字・小文字を区別しません）

安全性

Dart AI のすべての操作は本番環境で実行されます（サンドボックスはありません）。dart-query には次の機能があります。

• すべてのバッチ操作にドライランモード — 実行前にプレビューできます
• CSV インポートの検証フェーズ — 作成前にエラーを検出できます
• バッチ削除に必要な確認フラグ（confirm: true）
• 復元可能な削除 — タスクは完全に削除されず、ゴミ箱に移動します

ライセンス

MIT