Skip to content
CV-CUE MCP

Run it locally

If it’s just you, you don’t need the hosted app. Run the server locally over stdio with your key in a .env file.

Install

Section titled “Install”
Terminal window
git clone https://github.com/sharanmahadevan/cv-cue-mcp && cd cv-cue-mcp
python3.12 -m venv .venv
.venv/bin/pip install .
cp .env.example .env      # then fill in CVCUE_KEY_ID and CVCUE_KEY_VALUE

Claude Desktop

Section titled “Claude Desktop”

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cv-cue": {
      "command": "/path/to/cv-cue-mcp/.venv/bin/cv-cue-mcp",
      "env": { "CVCUE_ENV_FILE": "/path/to/cv-cue-mcp/.env" }
    }
  }
}

Claude Code

Section titled “Claude Code”
Terminal window
claude mcp add cv-cue -e CVCUE_ENV_FILE=/path/to/cv-cue-mcp/.env -- /path/to/cv-cue-mcp/.venv/bin/cv-cue-mcp

On-premises CV-CUE

Section titled “On-premises CV-CUE”

Use a local CV-CUE user instead of an API key:

Terminal window
CVCUE_BASE_URL=https://cvcue.example.internal/wifi/api
CVCUE_USERNAME=api-user
CVCUE_PASSWORD=...
CVCUE_VERIFY_SSL=false     # only for self-signed certificates

Local HTTP

Section titled “Local HTTP”
Terminal window
cv-cue-mcp --http --port 8000

This serves /mcp with your credentials and no authentication. Keep it on 127.0.0.1. To share a server, use the hosted mode (--hosted) instead.

Running the hosted app locally

Section titled “Running the hosted app locally”

For development, the full sign-in app runs locally with a password-less dev login:

Terminal window
CVCUE_PUBLIC_URL=http://localhost:8765 \
CVCUE_MASTER_KEY=$(python3 -c 'import os,base64;print(base64.urlsafe_b64encode(os.urandom(32)).decode().rstrip("="))') \
CVCUE_SESSION_SECRET=dev CVCUE_DB_PATH=./dev.db CVCUE_DEV_LOGIN=true \
cv-cue-mcp --hosted --host 127.0.0.1 --port 8765

CVCUE_DEV_LOGIN is refused unless the public URL is localhost.