@pixelvault-dev/local-mcp
A local (stdio) MCP server for PixelVault — agent-first image hosting, enabling upload of local files by path without base64.
README
@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
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
| Tool | What it does |
|---|---|
upload_image |
Upload by local path (streamed, no base64), or source_url, or data. Optional folder, visibility, expires_in. |
list_images |
List images in your project (paginated). |
get_image |
Metadata for one image by id. |
delete_image |
Permanently delete an image by id. |
sign_url |
Mint a time-limited signed URL for a private image. |
transform_image |
Build an on-the-fly transform URL (resize, crop, format, AI background removal, effects). |
Every returned CDN URL supports on-the-fly transforms via query params — see the transforms docs.
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.