# Visual Memory MCP

> Visual Memory MCP is an open-source MCP server for knowledge and memory. Local visual cache for coding agents using perceptual hashing and CLIP search. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Website:** https://visionmemorymcp.com
- **Repository:** https://github.com/putervision/vision-memory-mcp
- **MCP Registry name:** io.github.putervision/vision-memory-mcp
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-16

## About

Visual Memory MCP stores screenshots of web and app interfaces on your machine so a coding agent does not have to re-send and re-interpret the same image each turn. It runs as a stdio server and CLI from the npm package @putervision/vision-memory-mcp, needs Node 18.18 or newer, and the README describes it as zero-infrastructure and local-first.

Lookup happens in tiers. An in-memory cache and dHash or aHash matching handle exact or near-duplicate screens in under about five milliseconds; local CLIP embeddings searched in LanceDB catch layouts with small CSS changes; accessibility-tree comparison guards against false hits; and a vision model is the last fallback. The README claims more than 95 percent of input token space can be recovered.

Other features include registering design mockups as baselines to verify layout drift, snapshot save and diff, WebM or MP4 ingestion into a state timeline, element grounding to selectors and coordinates, and trajectory export for fine-tuning. The README lists 15 tools and CLI commands such as doctor, audit, metrics and view.

## Features

- **Tiered cache:** Matches screens through memory, perceptual hash, CLIP and vision fallback.
- **Visual baselines:** Registers mockups and flags layout drift against them.
- **Snapshots and diffs:** Saves visual memory checkpoints and compares them.
- **Video ingestion:** Turns WebM or MP4 recordings into searchable keyframe states.
- **Element grounding:** Maps elements to selectors and coordinates.
- **CLI diagnostics:** Offers doctor, audit, metrics and a graph viewer.

## Good for

- Cut vision token costs in a UI-testing agent
- Catch visual regressions against a design mockup
- Index end-to-end test recordings as searchable states
- Check which screens an agent has already seen

## Install

### Claude Code (Terminal)

```sh
claude mcp add vision-memory-mcp -- npx -y @putervision/vision-memory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vision-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/vision-memory-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vision-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/vision-memory-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vision-memory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@putervision/vision-memory-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vision-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/vision-memory-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vision-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/vision-memory-mcp"
      ]
    }
  }
}
```

## Tools

- `manage_visual_spec`: Register and verify design baselines.
- `compare_states`: Compare UI states for layout drift.
- `export_trajectories`: Export UI state transition paths.

## FAQ

### Does it run locally?

Yes, the README describes it as local-first with no infrastructure.

### What Node version is needed?

Node 18.18 or newer.

### Can it work offline?

A run flag skips the CLIP model download for air-gapped use.

### How many tools does it expose?

The README lists 15 core MCP tools.

### Is Visual Memory MCP free?

Yes. Visual Memory MCP is open source, so you can use and self-host it for free.

### How do I add Visual Memory MCP to Claude Code?

Run this command in your terminal: claude mcp add vision-memory-mcp -- npx -y @putervision/vision-memory-mcp

### What are the best alternatives to Visual Memory MCP?

The closest alternatives to Visual Memory MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/visual-memory-mcp
