English Français العربية

io.github.standardbeagle/dart-query

السجل الرسمي البيانات وقواعدها

Dart AI task management MCP with batch operations, DartQL selectors, CSV import, zero context rot

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @standardbeagle/dart-query
Claude Code 
claude mcp add dart-query -e 'DART_TOKEN=<your dart_token>' -- npx -y @standardbeagle/dart-query@0.3.5
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "dart-query": {
            "command": "npx",
            "args": [
                "-y",
                "@standardbeagle/dart-query@0.3.5"
            ],
            "env": {
                "DART_TOKEN": "<your dart_token>"
            }
        }
    }
}

متغيرات البيئة

  • DART_TOKEN إلزامي سري Your Dart AI API token (get it from: https://app.dartai.com/?settings=account)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. dart-query
  2. Quick Start
  3. Tools
  4. DartQL Selectors
  5. Safety
  6. License

dart-query

MCP server for Dart AI task management, optimized for batch operations and minimal context usage.

Instead of looping through tasks one-by-one (filling your context window with intermediate JSON), dart-query uses DartQL selectors and server-side batch operations to update hundreds of tasks in a single call. A 50-task update that would normally consume ~30K tokens takes ~200 tokens with zero context rot.

Quick Start

1. Get Your Dart AI Token

Visit https://app.dartai.com/?settings=account and copy your token (starts with dsa_).

2. Configure MCP

npx (recommended)

{
  "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. Verify
info({ level: "overview" })
4. Example: Batch Update
// 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
})

Tools

GroupToolsPurpose
Discoveryinfo, get_configExplore capabilities, workspace config
Task CRUDcreate_task, get_task, update_task, delete_task, add_task_commentSingle task operations
Querylist_tasks, search_tasksFind tasks with filters or full-text search
Batchbatch_update_tasks, batch_delete_tasks, get_batch_statusBulk operations with DartQL selectors
Importimport_tasks_csvBulk create from CSV with validation
Docslist_docs, create_doc, get_doc, update_doc, delete_docDocument management

See TOOLS.md for full parameter references, DartQL syntax, and CSV import format.

DartQL Selectors

SQL-92 WHERE clause syntax for targeting tasks in batch operations:

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

Operators: =, !=, <>, >, >=, <, <=, LIKE, IN, NOT IN, BETWEEN, IS NULL, IS NOT NULL, CONTAINS Aliases: INCLUDES/HAS → CONTAINS · <> → != LIKE wildcards: % = any characters, _ = single character (case-insensitive)

Safety

All Dart AI operations are production (no sandbox). dart-query provides:

  • Dry-run mode on all batch operations — preview before executing
  • Validation phase for CSV imports — catch errors before creating anything
  • Confirmation flag (confirm: true) required for batch deletes
  • Recoverable deletes — tasks move to trash, not permanent deletion

License

MIT

الأسئلة الشائعة

ما هو io.github.standardbeagle/dart-query؟

Dart AI task management MCP with batch operations, DartQL selectors, CSV import, zero context rot

كيف أثبّت io.github.standardbeagle/dart-query؟

يعمل على جهازك. في Claude Code: claude mcp add dart-query -e 'DART_TOKEN=<your dart_token>' -- npx -y @standardbeagle/dart-query@0.3.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.standardbeagle/dart-query إلى مفتاح API؟

نعم. يتطلب DART_TOKEN، وتضبطها في إعداداته.

هل io.github.standardbeagle/dart-query مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.standardbeagle/dart-query؟

ينشره standardbeagle. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.