Dart Query

🚀 dart-query

dart-query 是為 Dart AI 任務管理打造的 MCP 服務器，針對批量操作進行了優化，能最大程度減少上下文的使用。

它摒棄了逐個處理任務的方式（避免用中間 JSON 填滿上下文窗口），而是藉助 DartQL 選擇器和服務器端批量操作，在一次調用中就能更新數百個任務。原本更新 50 個任務可能需要消耗約 30K 個令牌，而使用 dart-query 僅需約 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 選擇器

在批量操作中，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 許可證。