Skip to content
MCP server

Guaardvark

Local MCP server giving editors image, video, RAG and code-map tools from Guaardvark

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Linux, macOS, Windows
Runs
Locally
Version
3.3.0
Listing updated
2 days ago

About Guaardvark

Guaardvark is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This server only works with the Guaardvark app installed, because it hands your editor tools that run on your own GPU. It starts as python -m backend.mcp over stdio, or over loopback streamable HTTP on 127.0.0.1:8788/mcp, and an install command writes the entry into detected clients: Cursor, Claude Code, Claude Desktop, Zed, Gemini and Grok.

It exposes 55 of the app's tools, grouped as generation (image, video, music, speech, background removal, inpainting), knowledge (document search and memory), code intelligence (repository maps, AST reads, dependency graphs) and workstation tasks such as GPU inspection and web search. Calls pass through the same circuit breaker, audit log and timeouts as the app's own agent loop.

It is default-deny: desktop control, agent control, system, browser and test-execution categories, and anything flagged dangerous or approval-required, are hidden unless you widen the allowlist in data/config/mcp.json. The HTTP transport is loopback-only and unauthenticated, so the docs advise stdio for editors on the same machine. Guaardvark is MIT-licensed and free; the cost is the hardware.

Install

Run in a terminal

claude mcp add guaardvark -- uvx guaardvark

Add to claude_desktop_config.json

{
  "mcpServers": {
    "guaardvark": {
      "command": "uvx",
      "args": [
        "guaardvark"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "guaardvark": {
      "command": "uvx",
      "args": [
        "guaardvark"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "guaardvark": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "guaardvark"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "guaardvark": {
      "command": "uvx",
      "args": [
        "guaardvark"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "guaardvark": {
      "command": "uvx",
      "args": [
        "guaardvark"
      ]
    }
  }
}

Tools this server provides (28)

Taken from the project documentation; the running server may differ.

generate_image
Listed tool of the Guaardvark MCP server.
generate_video
Listed tool of the Guaardvark MCP server.
generate_animation
Listed tool of the Guaardvark MCP server.
generate_music
Listed tool of the Guaardvark MCP server.
generate_music_video
Listed tool of the Guaardvark MCP server.
generate_speech
Listed tool of the Guaardvark MCP server.
edit_image
Listed tool of the Guaardvark MCP server.
inpaint_image
Listed tool of the Guaardvark MCP server.
outpaint_image
Listed tool of the Guaardvark MCP server.
remove_background
Listed tool of the Guaardvark MCP server.
search_knowledge_base
Listed tool of the Guaardvark MCP server.
list_documents
Listed tool of the Guaardvark MCP server.
get_document_outline
Listed tool of the Guaardvark MCP server.
read_document_section
Listed tool of the Guaardvark MCP server.
summarize_corpus
Listed tool of the Guaardvark MCP server.
save_memory
Listed tool of the Guaardvark MCP server.
search_memory
Listed tool of the Guaardvark MCP server.
get_repository_map
Listed tool of the Guaardvark MCP server.
read_ast_node
Listed tool of the Guaardvark MCP server.
search_code
Listed tool of the Guaardvark MCP server.
get_dependency_graph
Listed tool of the Guaardvark MCP server.
map_codebase
Listed tool of the Guaardvark MCP server.
search_codebase
Listed tool of the Guaardvark MCP server.
inspect_gpu
Listed tool of the Guaardvark MCP server.
read_logs
Listed tool of the Guaardvark MCP server.
web_search
Listed tool of the Guaardvark MCP server.
fetch_url
Listed tool of the Guaardvark MCP server.
analyze_website
Listed tool of the Guaardvark MCP server.

What it does

Media generation
Create images, video, music and speech on your own GPU.
Knowledge base search
Search and read sections of your private document index with citations.
Code intelligence
Map repositories, read AST nodes and trace dependency graphs.
One-command install
An install command writes the server entry into detected editor configs.
Default-deny tool list
Dangerous and approval-required tools stay hidden until allowlisted.
Audit and timeouts
Calls use the same circuit breaker and audit log as the app.

Good for

  • Generate a short product clip from inside Claude Code
  • Ask Cursor to search a private knowledge base and cite the section
  • Map a repository in Zed to find dormant modules
  • Remove a background or inpaint an image without leaving the editor

Pricing

Open source

MIT licence, free; hardware is the only cost

Prices change. Check guaardvark.com before you buy.

Guaardvark FAQ

Does it need the Guaardvark app?

Yes. The registry entry says the app must be installed.

Which editors are detected?

Cursor, Claude Code, Claude Desktop, Zed, Gemini and Grok.

Why 55 tools and not more?

The app has over 100 tools; desktop, shell, browser and other risky categories are hidden by default.

Is it free?

Yes. It is MIT-licensed with no subscription; you pay only for your hardware.

Is the HTTP transport secure for remote use?

No. It is loopback-only and unauthenticated, so use stdio for same-machine editors.

Is Guaardvark free?

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

How do I add Guaardvark to Claude Code?

Run this command in your terminal: claude mcp add guaardvark -- uvx guaardvark

What are the best alternatives to Guaardvark?

The closest alternatives to Guaardvark are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Guaardvark

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media