任务批量管理服务

dart-query 是一个用于 Dart AI 任务管理的 MCP 服务器,优化了批量操作和最小化上下文使用,适用于高效的任务查询和批量更新场景。

  • by standardbeagle
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 standardbeagle/dart-query

使用说明

dart查询

MCP服务器 飞镖AI 任务管理,针对批处理操作和最小的上下文使用进行了优化。

dart-query使用DartQL选择器和服务器端批处理操作在一次调用中更新数百个任务,而不是逐一循环任务(用中间JSON填充上下文窗口)。一个50个任务的更新通常会消耗约30K个令牌,需要约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 文件管理

看 TOOLS.md 有关完整的参数引用、DartQL语法和CSV导入格式。

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 · <> → != 喜欢通配符: % =任何字符, _ =单个字符(不区分大小写)

安全

Dart AI的所有操作都是生产(没有沙盒)。dart查询提供:

  • 干运行模式 在所有批处理操作上--执行前预览
  • 验证阶段 对于CSV导入,在创建任何内容之前捕获错误
  • 确认标志 (confirm: true)批量删除所需
  • 可恢复删除 --任务移动到垃圾箱,而不是永久删除

许可证

麻省理工学院