English Français العربية

Cue

السجل الرسمي مؤرشف الوسائط والتصميم

Cue — video answers with timestamp-level proof. Scenes and frames stay off until asked.

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

التثبيت

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

NPM package @sylphx/cue
Claude Code 
claude mcp add cue -- npx -y @sylphx/cue@0.3.5
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "cue": {
            "command": "npx",
            "args": [
                "-y",
                "@sylphx/cue@0.3.5"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. Cue
  2. Read a local video
  3. Jobs Cue is built for
  4. Tool surface
  5. Predictable defaults
  6. Why agents trust it
  7. Companion MCP tools
  8. Development
  9. License

Merged into anymd (2026-09-25). anymd reads PDFs, Office files, EPUB, web pages, images and video into clean Markdown for AI agents: npx -y @sylphx/anymd. This repository is archived.

Cue

Video answers with timestamp-level proof

Cue gives agents a local video timeline they can search and cite. The default read returns container metadata, streams, chapters, and embedded subtitles. Scenes and frames are separate.

npx -y @sylphx/cue

For Claude Code:

claude mcp add cue -- npx -y @sylphx/cue

Read a local video

{
  "sources": [{ "path": "/absolute/path/to/demo.mp4" }]
}

That call uses the fast profile. It returns container metadata, streams, chapters, and embedded subtitles. It does not detect scenes, extract frames, or run speech recognition.

Then ask:

“Which chapter covers the pricing change?”

Cue returns chapter and subtitle locators with timestamp_ms and the source hash. It does not invent a transcript. A quote search matches embedded subtitles only. Render or crop a frame afterwards with video_evidence, once you have a timestamp.

Jobs Cue is built for

Ask your agentCue returns
“Find this quote.”a timestamped match in embedded subtitles, when those subtitles exist
“Summarize this meeting.”chapters and embedded subtitles
“Where is the code shown?”one frame from video_evidence at a known timestamp
“What changed in this demo?”scene boundaries when profile is quality or include_scenes is set
“Give me the useful moments.”chapters, embedded subtitles, warnings, and gaps

Tool surface

ToolPurpose
read_videoDefault fast profile: container metadata, streams, chapters, and embedded subtitles. Scenes are opt-in.
search_videoSearch embedded subtitle cues. It does not run speech recognition.
video_evidenceNamed follow-up: render, crop, or OCR one frame at a timestamp

Predictable defaults

  • Omitted profile is fast: container metadata, streams, chapters, and embedded subtitles. No scenes, frames, or speech recognition.
  • profile quality adds ffmpeg scene detection. It does not extract frames or run speech recognition.
  • include_keyframes and include_transcript stay off. Setting either one on the shipped server returns a warning and an empty array.
  • OCR stays on video_evidence.
  • No cloud video API or frame-by-frame vision model is required.
  • Missing ffprobe or embedded subtitles is reported as a gap, not guessed around.

Why agents trust it

Every claim can point back to timestamp_ms, a stream index, a subtitle range, or the source hash. A frame index is present only after video_evidence.

Companion MCP tools

ProductJob
CitraPDF answers with page-level proof
IrisImage facts and pixel evidence
SpineRepository architecture and impact
LocusExact code-chunk retrieval
LookoutWeb research with source excerpts

Each product is independent. Install only the tools your agent needs.

Development

bun install
bun run build
bun test
cargo test
bun run benchmark:public-proof
bun run benchmark:release-gate

License

MIT

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

ما هو Cue؟

Cue — video answers with timestamp-level proof. Scenes and frames stay off until asked.

كيف أثبّت Cue؟

يعمل على جهازك. في Claude Code: claude mcp add cue -- npx -y @sylphx/cue@0.3.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Cue إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Cue مفتوح المصدر؟

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

من يصون Cue؟

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

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