EdidSmith MCP Server
OfficialProvides EDID/DisplayID parsing, link-budget solving, quirk lookup, and safe display override helpers for Linux/SteamOS DRM, including sysfs/debugfs integration.
Provides tools for EDID/DisplayID inspection and patching, CVT-RB2 link-budget solving, display quirk lookup, and safe macOS display override application with atomic snapshots and automatic rollback.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
EdidSmith
Clean-room EDID 1.4, CTA-861, and DisplayID 2.0/2.1 parser, VESA CVT-RB2 link-budget solver, display quirk catalog, and safe rollback override CLI and stdio MCP server for macOS Apple Silicon and Linux/SteamOS DRM.
Measured release binary (macOS arm64, stripped + ad-hoc codesigned): 907,312 bytes (~886 KB), 6.3 ms median --version cold start across 20 runs, zero third-party dependencies.
What It Does / What It Does Not Do
Capability | Status | Notes |
EDID 1.4 base block ( | Supported | Established/Standard timings, DTDs, |
Multi-block CTA-861 ( | Supported | Audio ( |
DisplayID 2.0/2.1 ( | Supported | Dual inner+outer checksums, |
VESA CVT-RB2 & Link-Budget Solver | Supported |
|
Safe EDID & DisplayID Patcher | Supported |
|
Safe Display Override & 15s Rollback | Supported |
|
Built-in Quirk DB & Stdio MCP Server | Supported | 6-entry quirk DB, |
Kernel extensions / SIP disabling | Not used | Zero kexts or DriverKit extensions; relies on standard macOS override plists or Linux DRM overrides |
Automatic WindowServer reload | Not supported | Writing macOS |
Related MCP server: RPA Video Editor MCP Server
Install & Uninstall
Build from source (macOS 14+ Apple Silicon or Swift 6 toolchain)
cd projects/edidsmith
# Or open-source build with all features unlocked offline:Homebrew (when tap release is published)
brew install raydeoliveira/tap/edidsmithUninstall
Remove the installed binary and optional license cache (~/.config/edidsmith/license.json) or override snapshots (~/.config/edidsmith/snapshots/). Use edidsmith edid restore before uninstalling if you applied a display override.
Quick Start
Human CLI
# 1. Inspect an EDID / DisplayID 2.1 fixture (or live attached display with `probe`)
edidsmith --version
# edidsmith 0.1.0 (commercial, arm64)
edidsmith edid inspect --fixture displayid21-5k-tiled
edidsmith quirks --vendor 3a4c --product 0574AI-Agent --json & --from-json - Usage
edidsmith edid budget --width 3840 --height 1080 --hz 60 --link usbc-2lane --jsonMeasured output:
{"data":{"bpc":8,"chroma":"444","dsc_enabled":false,"effective_required_gbps":6.271,"fits":true,"link":"usbc-2lane","link_capacity_gbps":12.96,"recommendation":"Fits usbc-2lane uncompressed (48.4% link utilization).","required_gbps":6.271,"solved_mode":{"bpc":8,"chroma":"444","fits":true,"height":1080,"pixel_clock_khz":261310,"refresh_hz":60,"stereo_layout":null,"width":3840},"timing":{"h_blank":80,"h_front_porch":8,"h_sync_positive":true,"h_sync_width":32,"height":1080,"interlaced":false,"pixel_clock_khz":261310,"preferred":false,"refresh_hz":60,"source":"cvt-rb2","stereo_mode":null,"v_blank":31,"v_front_porch":1,"v_sync_positive":false,"v_sync_width":8,"width":3840},"utilization_percent":48.4},"error":null,"ok":true,"schema_version":1}edidsmith quirks --vendor 3a4c --product 0574 --jsonMeasured output:
{"data":{"count":1,"matches":[{"category":"ar-glasses","known_issues":["macOS suppresses 3840x1080 Full-SBS DTD over USB-C DP Alt Mode without an explicit CVT-RB2 override.","Some USB-C 2-lane hubs restrict high-refresh 3840x1080@120Hz."],"manufacturer_code":"NRL","model_name":"XREAL Air / One AR Glasses","notes":"Verify 2-lane vs 4-lane USB-C DP Alt Mode budget before applying 120 Hz Full-SBS.","product_id_hex":"0574","quirk_id":"xreal-full-sbs","recommended_link":"usbc-4lane","recommended_presets":["full-sbs-1080p","full-sbs-1080p-120"],"vendor_id_hex":"3a4c"}]},"error":null,"ok":true,"schema_version":1}Pipe outputs across tools via --from-json - (upstream ok: false fails closed with exit 2 UPSTREAM_ENVELOPE_FAILED; explicit CLI flags override piped fields):
edidsmith edid patch --fixture xreal-ar-glasses --preset full-sbs-1080p --dry-run --json \
| edidsmith edid budget --from-json - --link hdmi21-frl3 --jsonStart the stdio JSON-RPC 2.0 MCP server (2024-11-05):
edidsmith mcpSafety & Rollback
Probe & Validate First:
probeprobes external displays only by default (exit 3if absent; pass--simor--fixture <name>for hardware-free runs).EDIDParservalidates both outer 128B block checksums and DisplayID0x70inner checksums before patching or applying.STW-003 Patcher Guards: Never overwrites Block 1 DisplayID (
0x70), never clobbers0xFC/0xFD/0xFE/0xFFdescriptors, rejects CTA DBC overflow (> 123B), and preservesdtdOffset == 0 -> 4alignment.Symlink Guard & Atomic Snapshots:
FileOverrideStorageAdapterchecks paths withlstat(exit 4on symlink traversal), snapshots existing overrides before writing, and verifies byte-for-byte readback.Non-TTY & 15s Signal Watchdog:
edid applyfails closed (exit 2) if stdin is non-interactive without--yes. Interactive runs wait up to--confirm-timeout <sec=15>using non-restartingsigaction(sa_flags = 0) +poll(); timeout (exit 1) orSIGINT/SIGTERM(exit 130) restores the exact prior override.Hardware Test Scope: All EDID/DisplayID codecs, link budgets, multi-display matching, Linux DRM sysfs/debugfs helpers,
lstatsymlink guards,openptySIGINTrollback (exit 130), Polar loopback HTTP licensing, CLI composability, and MCP stdio behavior pass automated tests on Apple Silicon macOS. Physical external 3D monitors and Linux kerneldebugfsnodes were not attached on the build host; test live overrides with--dry-runfirst.
Exit Codes & CLI Reference
Run edidsmith --help for human usage or edidsmith --describe for the JSON capability manifest.
Code | Meaning |
| Success |
| Runtime or rollback failure |
| Usage, invalid EDID, bandwidth exceeded, non-TTY without |
| External hardware or SPI symbol unavailable |
| Permission, symlink ( |
| Interrupted ( |
License & Security
Security policy: SECURITY.md
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to inspect and reverse-engineer large binaries through bounded stdio JSON-RPC 2.0 tools for graph queries, SSA facts, path solving, runtime grounding, and mod scaffolding.1AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to automate video editing tasks such as creating, inspecting, and saving projects, adding, splitting, and deleting clips, applying kinetic motion behaviors, and validating render parameters. Supports JSON-RPC 2.0 over stdio and HTTP.MIT
- FlicenseNot gradedqualityBmaintenanceEnables agents to probe hardware and media capabilities, look up game depth profiles, inspect media, render 2D-to-3D stereo images, convert MV-HEVC spatial video, and capture frames through a stdio JSON-RPC interface.-
- FlicenseNot gradedqualityBmaintenanceEnables agents to probe supported 3D displays and UVC eye trackers, switch or restore lens modes over DDC/CI and USB-HID, and run eye-tracked lenticular weaving and calibration workflows through stdio MCP tools.-