mcpbeat Sign in

three.ws Vision MCP Server

local only

three.ws Vision runs on your own machine — the client starts it, so there is no endpoint to ping. 134 installs a week from npm. Last commit 1 Nov 2026.

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

Installs per day peak 38 · avg 12 · +120% w/w
a month agotoday
134
Installs / week
npm · @three-ws/vision-mcp
264
Stars
6 open issues
1 Nov 2026
Last commit
1 release in 90 days
Apache-2.0
License
JavaScript

What the code does

We read the source, 1 d ago · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a file or shell call animation_signature.clip → packages/render/bin/tty.js:150, apply_animation.animation → packages/render/bin/tty.js:78
        await fs.writeFile(out, bytes);
Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

Reaches cloud metadata service api/_lib/gcp-auth.js:91
        'http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token',
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

                    filePath = path.join(ROOT_PUBLIC, url);
    const child = spawn(command[0], command.slice(1), { stdio: 'inherit', shell: false });
Executes code built at runtime packages/blender-mcp/src/py/runner.py:716
        exec(compile(job["code"], "<three-ws-blender-mcp>", "exec"), namespace)
Builds a database query by concatenation api/_lib/gateway/audio.js:168
    const [row] = await sql`SELECT voice_provider, voice_id FROM agent_identities WHERE id = ${agentId}`.catch(() => []);
    return subprocess.run(
            if (reset) { state.cursor = null; state.total = 0; grid.innerHTML = skeletons(); stateEl.hidden = true; }
    'UklGRmQBAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YUABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA…
const TELEGRAM_API = 'https://api.telegram.org';

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add vision-mcp -- npx -y @three-ws/vision-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.vision-mcp]
command = "npx"
args = ["-y", "@three-ws/vision-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "vision-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

Alternatives to three.ws Vision

same job, measured the same way
Primateintelligence
by primateintelligence

Video scene understanding for AI agents via the Primate Vision API.

95 installs/wk answering
SammaPix — Image & PDF tools for AI agents
by samma1997

Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.

answering
ImageStep
by imagestep

The image pipeline for agents: presets, assets and jobs. Answers with asset ids and stable URLs.

493 installs/wk answering
Qencode
by qencode

Video pipeline for AI agents: analyze with AI, transcode to MP4/HLS/DASH, edit, protect and deliver.

answering
Vision Squeezer
by eralpozcan

Shrink images to a token budget for vision LLM agents and pipelines. Not for chat-pasted images.

416 installs/wk local only
Visily UI Design
by visily-app

UI design from prompts, screenshots, and URLs for AI coding agents and theme tokens.

answering
Anylens
by slowper

Turn videos, PDFs, screenshots, and articles into anchored, cached understanding for agents.

51 installs/wk local only
Image Recongnition MCP
by shalevshalit

MCP server for AI-powered image recognition and description using OpenAI vision models.

50 installs/wk local only

three.ws Vision — questions

Answers built from our own checks of this server.

Why is there no uptime for three.ws Vision?
three.ws Vision runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @three-ws/vision-mcp was installed 134 times last week.
How do I connect three.ws Vision?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @three-ws/vision-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use three.ws Vision?
The npm package @three-ws/vision-mcp was installed 134 times in the last week. Week over week that is +120%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is three.ws Vision open source?
Yes — it is published under the Apache-2.0 licence, written in JavaScript, 264 stars on GitHub and 6 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.