媒体分析MCP服务器

General notes:

• The tool accepts a single JSON object as its input (the MCP arguments).
• At least one of path, paths, or cursor is required. When paths carries at least one valid entry, path is ignored (explicit ignore-path contract: sending both is allowed, path is silently ignored — prefer oneOf semantics and send only one). A cursor (from a truncated response) reads the next window of the list without uploading or analyzing anything.
• Paths must be absolute on the machine running the MCP server, or http(s) URLs. URLs are downloaded to a temporary directory on the MCP host (up to 64 MiB each; localhost and private-network destinations are blocked) and deleted after analysis. A solitary URL above 64 MiB escalates to EnriProxy's server-side source_url ingestion (resumable download with extra hops); local files use resumable upload up to 4 GiB.
• EnriVision does not accept per-call server_url/api_key overrides (these are configured via env vars).
• Nothing you send is dropped quietly: any unrecognized parameter is rejected with the Spanish coaching Parámetro no reconocido: <keys>. Parámetros aceptados: <real list> (top level and inside video/audio/document/images/region), closed enums (analysis_mode, delivery) reject any present non-null value that is not exactly a valid selector (non-strings included; null/blank count as omitted), and two spellings of the same knob with different values (e.g. max_frames + maxFrames) are rejected — send a single spelling. A flat value that differs from its nested counterpart applies the flat (documented precedence) and declares it in warnings.

analyze_media

Inputs:

• path (string, optional): absolute local file path, or one http(s) URL to download and analyze (up to 64 MiB; a solitary larger URL escalates to server-side source_url ingestion).
• paths (string[], optional): absolute local image paths or http(s) image URLs (useful for UI screenshot sets).
• context (string, optional): high-level hint (examples: ui, diagram, chart, error, code, meeting, tutorial, photo).
• question (string, optional): what you want to extract/answer.
• language (string, optional): preferred response language (ISO 639-1; e.g., es, en). If omitted, uses ENRIVISION_DEFAULT_LANGUAGE when set.
• analysis_mode (string, optional): auto | single | multipass.
• max_frames (number, optional): single-pass video frames (1..20).
• model (string, optional): model id for server-side dispatch affinity (max 128 chars; env ENRIVISION_MODEL; omit for auto-dispatch).
• region (object, optional): relative [0,1] zoom box {x, y, width, height} for one image (native-resolution reading of small text); single images only.
• transcribe (boolean, optional): enable/disable transcription (videos). Has no effect on images/documents (declared in warnings, ignored).
• transcription_language (string, optional): whisper hint (auto, es, en, ...).

Continuation:

• cursor (string, optional): opaque cursor from a truncated response (segment_summaries_cursor or transcription_segments_cursor); reads the next window without re-analyzing.
• offset (integer, optional): continuation start index (defaults to the response next_offset).
• limit (integer, optional): continuation window length (1..100; defaults to the server window size).

Video targeting:

• video.clip_start_seconds (number, optional)
• video.clip_duration_seconds (number, optional)
• video.clip_end_seconds (number, optional; end = start + duration, wins over clip_duration_seconds)

Multipass tuning (advanced; used only for analysis_mode: multipass):

• video.segment_seconds (number, optional)
• video.max_segments (number, optional)
• video.max_frames_per_segment (number, optional)
• document.max_pages_total (number, optional)
• document.pages_per_batch (number, optional)
• document.max_images_per_batch (number, optional)
• document.scanned_text_threshold_chars (number, optional)
• audio.timestamps (boolean, optional)
• audio.segment_seconds (number, optional)
• audio.max_segments (number, optional)
• images.max_images_total (number, optional)
• images.images_per_batch (number, optional)
• images.max_dimension (number, optional)

Output:

• analysis (string): model-produced analysis.
• media_type (string): detected media type (video, audio, image, document, image_set).
• extraction (object): safe metadata summary (internal routing details are stripped).

Example arguments object:

{
  "path": "C:\\path\\to\\video.mp4",
  "question": "What are the key steps demonstrated?",
  "analysis_mode": "auto",
  "transcribe": true,
  "language": "es"
}

Many MCP clients include a built-in Read(...) tool that can ingest local files and attach them to the model request. This is convenient, but the set of supported formats is limited and can change across client versions.

If the file you need to analyze is not reliably supported by your client (for example .avif, .heic, .svg, videos, audio, or Office documents), prefer EnriVision MCP so the client can upload bytes and EnriProxy can do extraction reliably.

EnriProxy determines media type using content-type and extension allow-lists.

Videos:

• .mp4, .mov, .avi, .mkv, .webm, .m4v, .wmv, .flv, .3gp, .3g2, .ts, .mts, .m2ts, .mpeg, .mpg, .gif

Audio:

• .mp3, .mp1, .mp2, .mpa, .mpga, .wav, .aiff, .aif, .aifc, .caf, .flac, .m4a, .m4b, .m4r, .aac, .ogg, .oga, .wma, .opus, .weba, .mka

Images:

• .png, .apng, .jpg, .jpeg, .gif, .webp, .avif, .heic, .heif, .tiff, .tif, .bmp, .svg, .ico

Documents:

• .pdf, .docx, .pptx, .xlsx