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 user3.验证
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 'Done'
title LIKE 'Task%' -- starts with
title LIKE '%auth%' -- contains substring操作员: =, !=, <>, >, >=, ` → != **喜欢通配符:** % =任何字符, _` =单个字符(不区分大小写)
安全
Dart AI的所有操作都是生产(没有沙盒)。dart查询提供:
- 干运行模式 在所有批处理操作上--执行前预览
- 验证阶段 对于CSV导入,在创建任何内容之前捕获错误
- 确认标志 (
confirm: true)批量删除所需 - 可恢复删除 --任务移动到垃圾箱,而不是永久删除
许可证
麻省理工学院
