EnriVision MCP Server

EnriVision

EnriVision is a Model Context Protocol (MCP) server over stdio that uploads local media to EnriProxy and returns server-side extraction + model analysis.

This is useful for media types that many MCP clients cannot read reliably (videos, audio, scanned PDFs, HEIC/AVIF, large files), while keeping the MCP server itself lightweight.

What this project is

• An MCP server process your MCP host launches (OpenCode, Claude Code, Codex, etc.)
• A thin client for EnriProxy (resumable upload + structured output)

Requirements

• Node.js >= 22 (recommended: Node 24 LTS)
• A reachable EnriProxy server with these endpoints enabled:
  • POST /v1/uploads
  • HEAD /v1/uploads/:id
  • PATCH /v1/uploads/:id
  • POST /v1/vision/analyze
• An EnriProxy API key (configured on the EnriProxy side)

Install

# Global install
npm install -g @bedolla/enrivision

# Or run without installing
npx -y @bedolla/enrivision@latest --help

Build

npm install
npm run typecheck
npm run build

Usage

1) Configure your MCP host

EnriVision runs as an MCP server over stdio. Your MCP host is responsible for launching the process.

Example: global install

{
  "EnriVision": {
    "type": "stdio",
    "command": "enrivision",
    "args": [],
    "env": {
      "ENRIPROXY_URL": "http://127.0.0.1:8787",
      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY",
      "ENRIVISION_DEFAULT_LANGUAGE": "es"
    }
  }
}

Example: no install (always uses whatever npm currently tags as latest)

{
  "EnriVision": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@bedolla/enrivision@latest"],
    "env": {
      "ENRIPROXY_URL": "http://127.0.0.1:8787",
      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY",
      "ENRIVISION_DEFAULT_LANGUAGE": "es"
    }
  }
}

{
  "EnriVision": {
    "type": "stdio",
    "command": "node",
    "args": ["C:\\\\Users\\\\Administrator\\\\Projects\\\\EnriVision\\\\dist\\\\index.js"],
    "env": {
      "ENRIPROXY_URL": "http://127.0.0.1:8787",
      "ENRIPROXY_API_KEY": "YOUR_ENRIPROXY_API_KEY",
      "ENRIVISION_DEFAULT_LANGUAGE": "es"
    }
  }
}

Configuration

EnriVision is configured via environment variables:

• ENRIPROXY_URL (string, optional, default: http://127.0.0.1:8787)
• ENRIPROXY_API_KEY (string, required)
• ENRIVISION_TIMEOUT_MS (string, optional, default: 1800000)
  • Parsed as an integer (milliseconds). Uploads are performed in chunks; this timeout applies per request.
• ENRIVISION_DEFAULT_LANGUAGE (string, optional)
  • Default language to send when the tool call does not provide language.

MCP tools

EnriVision exposes this MCP tool:

• analyze_media