# Guaardvark

> Guaardvark is an open-source MCP server for design and media. Local MCP server giving editors image, video, RAG and code-map tools from Guaardvark. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, macOS, Windows, CLI, self-hosted
- **Website:** https://guaardvark.com/mcp/
- **Repository:** https://github.com/guaardvark/guaardvark
- **MCP Registry name:** io.github.guaardvark/guaardvark
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add guaardvark -- uvx guaardvark
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [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.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/guaardvark
