How do I install Clipquery?

Clipquery is a local plugin. Install it using npm package: @reneturcios/clipquery and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Clipquery safe to use?

Clipquery was flagged by MCP Marketplace's security scan, scoring 4.8/10 (high risk). It has 2 high or critical findings to review. Review the security report on this page carefully before installing it.

What AI apps work with Clipquery?

Clipquery uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Clipquery MCP Server

by CloudCorpRecords

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8

Use Caution4.8High Risk

clipquery is a small, well-structured search client that sends the query and a user ID to a user-configured Flashback API base URL and validates the responses it gets back. The main concerns are that the account user ID is the only identity credential, with no token or auth header, and that nothing enforces HTTPS on the base URL, so the ID could travel in cleartext. Permissions match the stated purpose, and no malicious or dangerous patterns were found. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-cloudcorprecords-clipquery": {
      "args": [
        "-y",
        "@reneturcios/clipquery"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

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

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

MCP server

npx -y @reneturcios/clipquery mcp

MCP client config:

{
  "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

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

Development

npm install
npm 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

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.