mcp-media-toolbox
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_video_infoA | 获取本地媒体文件的容器、时长、视频流（编码/分辨率/帧率/码率）与音频流（编码/声道/采样率/AAC 参数）；对图片返回 JPEG/PNG/GIF 尺寸，其他文件返回魔数嗅探。纯 JS 解析，不需要 ffprobe。参数为本地绝对路径。 |
| extract_audio_trackA | 把 mp4/m4a 里的 AAC 音轨按样本表(stsz/stco/stsc)直抽出来，手工构造 ADTS 头写成 .aac 裸流，可直接播放或喂给语音识别。本机无 ffmpeg，故不做重采样/转 WAV。 |
| get_system_hardwareA | 获取宿主机 CPU 架构、操作系统、内存、磁盘、Node 运行时版本与 MCP 服务信息，供 Agent 决策本地算力分配。 |
| probe_dirA | 批量体检一个目录：逐个文件的类型（魔数嗅探）、大小、修改时间，视频给出时长/分辨率/编码，图片给出尺寸，并按图片/视频/音频/文档/压缩包汇总占用。比逐个调 get_video_info 省往返。 |
| storage_reportA | 分析一个目录的空间都去哪了：Top 子目录、按文件类型（图片/视频/音频/文档/压缩包）的占用分布、最大的几个文件。用于「手机空间不够了帮我看看」。 |
| find_duplicatesA | 找出目录里的重复文件：先按文件大小分组，只对同尺寸的候选算 sha256 确认，返回重复组、可回收空间。适合清理相册里重复保存的图片。只读，不删除。 |
| read_exifA | 读取 JPEG 的 EXIF：拍摄时间（DateTimeOriginal）、机型、GPS 经纬度、光圈/快门/ISO/焦距、像素尺寸，并对比文件修改时间提示「文件时间是否可信」。传目录则批量汇总（有 EXIF 几张、时间跨度、机型分布）。用于按真实拍摄时间整理相册。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools target clearly distinct operations: single-file inspection, bulk directory inspection, space analysis, duplicate finding, EXIF reading, audio extraction, and system info. The two potential overlaps (get_video_info vs probe_dir on per-file detail, probe_dir vs storage_report on type aggregation) are explicitly disambiguated by the descriptions ('比逐个调 get_video_info 省往返', '分析空间去哪了' vs per-file listing).
All names are snake_case and six of seven follow a verb_noun pattern (get_video_info, extract_audio_track, get_system_hardware, probe_dir, find_duplicates, read_exif). storage_report is the one noun-phrase outlier, a minor deviation but still readable and in-family.
Seven tools is well within the 3-15 sweet spot and each covers a distinct analysis task. No obvious filler; get_system_hardware is slightly tangential to media but justified as local-compute context for an agent.
The surface is solid for read-only inspection/analysis (info, directory probing, storage, duplicates, EXIF, audio extraction). However it is entirely read-only: there is no tool to actually reorganize/move/rename/delete files, even though read_exif is pitched as '整理相册' and duplicates are found but not removable—leaving agents at a dead end after analysis.