Clipquery

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 3, 2026

用自然語言搜尋已處理的影片庫，並返回符合的影片片段。

AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。

原文描述

Search your processed video library in natural language and get matching segments back.

已驗證STDIO僅桌面

概覽

Clipquery 的本機 MCP 服務；無需登入；STDIO。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clipquery，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

clipquery

Search a personal video library with natural language. Videos processed by the Flashback system are split into ~30-second segments, analysed for visual content, transcribed, and embedded; a query is matched semantically against those segments, and each result comes back with an AI-generated description, a relevance score (0–1), a direct URL to view the segment, and the time that URL expires. Presigned URLs expire after 1 hour — run the query again for fresh ones.

Configuration

Two environment variables are required for query_videos:

  • FLASHBACK_USER_ID — your unique Flashback account identifier (e.g. 4087fce3-3d86-4047-b35f-4004b4c19192)
  • FLASHBACK_API_BASE_URL — the base URL of the Flashback video processing API. The upstream publishes no default, so this must be set; a missing value is an error naming the variable, raised before any request.

get_setup_instructions is local and needs no configuration.

CLI

bash
npx @reneturcios/clipquery query "person talking" --max-results 5npx @reneturcios/clipquery query "meeting discussion about deadlines"npx @reneturcios/clipquery setupnpx @reneturcios/clipquery --version

Exit codes: 0 on success, 1 on a runtime error (including missing configuration), 2 on a usage error.

MCP server

bash
npx -y @reneturcios/clipquery mcp

MCP client config:

json
{  "mcpServers": {    "clipquery": {      "command": "npx",      "args": ["-y", "@reneturcios/clipquery", "mcp"],      "env": {        "FLASHBACK_USER_ID": "your-flashback-user-id",        "FLASHBACK_API_BASE_URL": "https://your-flashback-api-host"      }    }  }}

Tools

  • query_videos — Search for video clips based on natural language query. query (string, required) — natural language description of what you're looking for; max_results (integer, optional, default 10) — maximum number of results to return (1–15).
  • get_setup_instructions — Get detailed setup instructions for the video query system. No parameters.

The server also mirrors the upstream's documented resource URI concept in its guide text only; no MCP resources are served.

Docker

bash
docker run -i -e FLASHBACK_USER_ID -e FLASHBACK_API_BASE_URL ghcr.io/cloudcorprecords/clipquerydocker run --rm ghcr.io/cloudcorprecords/clipquery setup

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # tsx --test test/*.test.ts (fake fetch only, no network)npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios

來源：README.md，提交 9634272

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Nov 3, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分