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 许可证。