three.ws Vision MCP Server

by nirholasio.github.nirholas/vision-mcpv0.1.1

Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.

228Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install three.ws Vision MCP server

claude mcp add vision -- npx -y @three-ws/vision-mcp

{
  "mcpServers": {
    "vision": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "vision": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "vision": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "vision": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
THREE_WS_BASE	—	—	Base URL of the three.ws API that serves the vision endpoint. Override only when self-hosting or targeting a preview deployment.
THREE_WS_TIMEOUT_MS	—	—	Per-request timeout in milliseconds for the vision call (the VLM may chain across free lanes before answering).
THREE_WS_API_KEY	—	—	Optional three.ws API key (bearer token). Not required — the vision endpoint serves anonymous callers on a free per-IP rate limit. Set it to raise your rate limit to the per-user tier. Never needed to access the free model.