Vizer MCP Proxy

A cross-platform stdio proxy that bridges MCP (Model Context Protocol) requests to the Vizer Cloud API.

Installation

Pre-built Binaries

Download the appropriate binary for your platform from the releases page:

• vizer-mcp-proxy-win.exe - Windows x64
• vizer-mcp-proxy-macos - macOS x64
• vizer-mcp-proxy-macos-arm64 - macOS ARM64 (Apple Silicon)
• vizer-mcp-proxy-linux - Linux x64

From Source

npm install
npm run build

Usage

With Windsurf/Cursor MCP Config

Add to your MCP configuration:

{
  "mcpServers": {
    "vizer": {
      "command": "/path/to/vizer-mcp-proxy",
      "args": ["--install-id=YOUR_INSTALL_ID"],
      "env": {
        "VIZER_WORKER_URL": "https://api.vizer.codes"
      }
    }
  }
}

CLI Arguments

| Argument | Description | Default | |----------|-------------|---------| | --install-id=ID | Your Vizer Install ID | (required) | | --worker-url=URL | Vizer Cloud API URL | https://api.vizer.codes |

Environment Variables

| Variable | Description | |----------|-------------| | VIZER_WORKER_URL | Override the default cloud API URL |

MCP Protocol

This proxy implements the MCP stdio transport protocol:

Supported Methods

• initialize - Protocol handshake
• notifications/initialized - Initialization acknowledgment
• tools/list - List available Vizer tools
• tools/call - Execute a Vizer tool

Available Tools

The proxy exposes all tools from the Vizer Cloud MCP API:

• get_health_snapshot - Get system health status
• get_console_logs - Retrieve console logs
• get_network_requests - Get network request data
• get_supervisor_status - Check Supervisor status
• get_pending_tasks - List pending tasks
• get_user_intents - Get observed user intents
• trigger_supervisor_run - Manually trigger Supervisor
• sync_brain_docs - Sync Brain documentation

Building Binaries

To create standalone executables:

npm run package

This creates binaries in dist/:

• vizer-mcp-proxy-win.exe
• vizer-mcp-proxy-macos
• vizer-mcp-proxy-macos-arm64
• vizer-mcp-proxy-linux

Development

# Install dependencies
npm install

# Run in development mode
npm run dev -- --install-id=test123

# Build TypeScript
npm run build

# Run built version
npm start -- --install-id=test123

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐     HTTP      ┌──────────────┐
│   AI Assistant  │ ──────────────▶│  vizer-mcp-proxy │ ────────────▶│ Vizer Cloud  │
│ (Windsurf/etc)  │ ◀────────────── │                  │ ◀──────────── │    API       │
└─────────────────┘                └──────────────────┘               └──────────────┘

License

MIT © Vizer