@pixelvault-dev/local-mcp

A local (stdio) MCP server for PixelVault — agent-first image hosting.

The difference from the hosted MCP server (mcp.pixelvault.dev): this one runs on your machine, so it can upload a local file by path. It reads the bytes off disk and streams them to the API as multipart/form-data — the file is never base64-encoded into the model's context. That keeps large images (and slow, token-hungry base64 round-trips) out of the conversation.

Use the hosted server when your client is remote (ChatGPT, etc.); use this one for local coding agents that have files on disk.

Install

Runs with npx — no global install needed:

npx @pixelvault-dev/local-mcp

Related MCP server: mcp-sanity-images

Configure

Set your PixelVault API key (a pv_live_… secret key for private uploads):

export PIXELVAULT_API_KEY=pv_live_xxx
# optional: point at a different API
export PIXELVAULT_API_URL=https://api.pixelvault.dev

The server also reads ~/.pixelvault/config.json if you've authenticated with the PixelVault CLI (pixelvault login).

Claude Desktop / MCP client config

{
  "mcpServers": {
    "pixelvault": {
      "command": "npx",
      "args": ["-y", "@pixelvault-dev/local-mcp"],
      "env": { "PIXELVAULT_API_KEY": "pv_live_xxx" }
    }
  }
}

Tools

Every returned CDN URL supports on-the-fly transforms via query params — see the transforms docs.

License

MIT