video-db/agent-toolkit

[![GitHub tag (latest SemVer)][tag-shield]][ tag-url]
[![Stars][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
VideoDB Agent Toolkit
AI Agent toolkit for VideoDB
llms.txt >>
llms-full.txt
MCP
VideoDB Agent Toolkit
The VideoDB Agent Toolkit exposes VideoDB context to LLMs and agents. It enables integration to AI-driven IDEs like Cursor, chat agents like Claude Code etc. This toolkit automates context generation, maintenance, and discoverability. It auto-syncs SDK versions, docs, and examples and is distributed through MCP and llms.txt
🚀 Quick Overview
The toolkit offers context files designed for use with LLMs, structured around key components:
llms-full.txt — Comprehensive context for deep integration.
llms.txt — Lightweight metadata for quick discovery.
MCP (Model Context Protocol) — A standardized protocol.
These components leverage automated workflows to ensure your AI applications always operate with accurate, up-to-date context.
📦 Toolkit Components
1. llms-full.txt (View »)
---
llms-full.txt consolidates everything your LLM agent needs, including:
- Comprehensive VideoDB overview.
- Complete SDK usage instructions and documentation.
- Detailed integration examples and best practices.
**Real-world Examples:**
- VideoDB's Director code-assistant agent (View Implementation )
- VideoDB's Discord Bot to power customer support and community help (View Implementation )
- Integrate llms-full.txt directly into your LLM-powered workflows, agent systems, or AI coding environments.
2. llms.txt (View »)
---
A streamlined file following the Answer.AI llms.txt proposal. Ideal for quick metadata exposure and LLM discovery.
> **ℹ️ Recommendation**: Use llms.txt for lightweight discovery and metadata integration. Use llms-full.txt for complete functionality.
3. MCP (Model Context Protocol)
The VideoDB MCP Server connects with the Director backend framework, providing a single tool for many workflows. For development, it can be installed and used via uvx for isolated environments. For more details on MCPs, please visit here
**Install uv**
We need to install uv first.
For macOS/Linux:
For Windows:
You can also visit the installation steps of uv for more details here
**Run the MCP Server**
You can run the MCP server using uvx using the following command
**Update VideoDB Director MCP package**
To ensure you're using the latest version of the MCP server with uvx, start by clearing the cache:
This command removes any outdated cached packages of videodb-director-mcp, allowing uvx to fetch the most recent version.
If you always want to use the latest version of the MCP server, update your command as follows:
🧠 Anatomy of LLM Context Files
LLM context files in VideoDB are modular, automatically generated, and continuously updated from multiple sources:
🧩 Modular Structure:
- **Instructions** — Best practices and prompt guidelines View »
- **SDK Context** — SDK structure, classes, and interface definitions View »
- **Docs Context** — Summarized product documentation View »
- **Examples Context** — Real-world notebook examples View »
Automated Maintenance:
- Managed through GitHub Actions for automated updates.
- Triggered by changes to SDK repositories, documentation, or examples.