# Guaardvark

Hooks your agent up to a self-hosted studio on your own GPU: chat over your files, plus video, image, music and voice generation. The Guaardvark app must be installed.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 282
- Author: guaardvark
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/guaardvark/guaardvark
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/guaardvark

## What it does

This MCP server opens Guaardvark's flows to Claude Code, Codex, Cursor, Copilot and other agents: retrieval over your own documents, agents driving a real desktop, parallel coding agents, and generators for video, images, music and speech. The work happens on your hardware through Ollama, ComfyUI and Guaardvark's GPU services.

The server starts with `uvx guaardvark`, so `uv` has to be present. The Guaardvark application itself needs to be running already — the server has nothing to talk to otherwise. Desktop, shell and browser tools stay hidden until you allowlist them, which is a deliberate choice by the authors and caps what an agent can touch on your machine.

The studio targets Linux with an NVIDIA card. Video generation is advised to have 16 GB of VRAM, the Wan 2.2 5B model fits in 12 GB, and chat, RAG and agents get by with less. On a fresh Ubuntu, install `curl` and `git` first.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add guaardvark -- uvx guaardvark
```
uvx runs the command named after the package; if the README names another one, use uvx --from guaardvark <command>

### Codex

**Platform CLI**
```bash
codex mcp add guaardvark -- uvx guaardvark
```
uvx runs the command named after the package; if the README names another one, use uvx --from guaardvark <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "guaardvark": {
            "command": "uvx",
            "args": [
                "guaardvark"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from guaardvark <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "guaardvark": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "guaardvark"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from guaardvark <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add guaardvark uvx guaardvark
```
uvx runs the command named after the package; if the README names another one, use uvx --from guaardvark <command>

## When to use it
- wire local video and image generation into Claude Code
- search your own documents without shipping them to a cloud
- run parallel coding agents in separate git worktrees
- generate a song or a voiceover straight from the agent chat
- train a character LoRA from a few photos on your own GPU

## Example prompts
- Connect the Guaardvark MCP server and list the tools it exposes
- Make a music video from this track with Guaardvark
- Swarm this refactor with coding agents

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26559
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9289

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md