dart-query

dart-query

适用于 Dart AI 任务管理的 MCP 服务，针对批量操作和最小化上下文使用进行了优化。

与逐个循环处理任务（用中间 JSON 填满上下文窗口）不同，dart-query 使用 DartQL 选择器和服务端批量操作，只需一次调用即可更新数百个任务。通常需要消耗约 30K 个 token 的 50 个任务更新，现在只需约 200 个 token，且不会造成上下文腐化。

快速开始

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 通配符： % = 任意字符，_ = 单个字符（不区分大小写）

安全性

所有 Dart AI 操作都针对生产环境（无沙盒）。dart-query 提供：

• 所有批量操作均支持试运行模式——执行前预览
• CSV 导入包含验证阶段——在创建任何内容前捕获错误
• 批量删除需要确认标志（confirm: true）
• 可恢复删除——任务会移至回收站，而非永久删除

许可证

MIT