Ask your AI agent what's inside a media file
The Media Analyzer MCP server brings the same parsing engine that powers this site to Claude Code, Claude Desktop, and any other MCP-capable agent. Your agent can open local media files, inspect streams and packets, and read every decoded header field — while the files themselves stay on your machine.
Nothing to install
The server ships as the @vtclab/analyzer-mcp (opens in new tab) npm package. All you need is Node.js 18+. On first launch the package downloads and caches the matching native binary for your platform, so the same command works on macOS, Linux, and Windows:
npx -y @vtclab/analyzer-mcpYou don't run it by hand: this is the command your MCP client launches to start the server. Register it once and you're done.
Connect your AI agent
For Claude Code, register the server with one command:
claude mcp add media-analyzer -- npx -y @vtclab/analyzer-mcpFor Claude Desktop or any other MCP client, add the server to the client's MCP configuration (for example claude_desktop_config.json):
{
"mcpServers": {
"media-analyzer": {
"command": "npx",
"args": ["-y", "@vtclab/analyzer-mcp"]
}
}
}What your agent can do
analyze_media_fileStructural summary of a file: detected streams, sizes, and packet counts.list_streamsStream hierarchy with codecs and identifiers.list_packetsPaginated packet list, optionally filtered by stream.get_packetFull decoded header of one packet, every field with its description.get_packet_rawRaw reconstructed packet bytes as hex, for opaque payloads.list_scan_errorsGenuine parse errors encountered while scanning the file.list_supported_formatsContainers and codecs the analyzer can parse.Example prompts
- Analyze ~/Videos/clip.mp4 and tell me what's inside.
- What resolution and codec parameters does the video stream in this file use?
- Check the packets around the second keyframe — are the timestamps monotonic?
- List any parse errors in this transport stream and explain what they mean.
Good to know
Parsing stays local
The server parses files on your machine; nothing is uploaded to us. Only the parsed fields your agent requests become part of its conversation context.
Local file paths
Tools take paths to files on the machine where the server runs — point your agent at files on disk.
Fast repeated questions
Parsed files are cached (the last 4, keyed by path and modification time), so follow-up questions about the same file answer quickly. Editing a file refreshes its cache entry automatically.
Free for now
The MCP server is currently free to use — no signup and no license key required.