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. 例: バッチ更新

// まずプレビュー
batch_update_tasks({
  selector: "dartboard = 'Engineering' AND priority = 'high'",
  updates: { status: "Doing" },
  dry_run: true
})

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

✨ 主な機能

完全なパラメーターリファレンス、DartQL構文、およびCSVインポート形式については、TOOLS.md を参照してください。

📚 ドキュメント

DartQLセレクター

バッチ操作でタスクを対象とするためのSQLのようなWHERE句です。

dartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'
due_at < '2026-01-18' AND status != 'Done'
title LIKE '%auth%'

🔧 セキュリティ

すべてのDart AI操作は本番環境で行われます（サンドボックスではありません）。dart-queryは以下の機能を提供します。

• すべてのバッチ操作におけるドライランモード — 実行前にプレビュー
• CSVインポートの検証フェーズ — 何かを作成する前にエラーを検出
• バッチ削除に必要な確認フラグ (confirm: true)
• 回復可能な削除 — タスクはゴミ箱に移動し、永久削除されません

📄 ライセンス

MIT