# VIVATLAS

> VIVATLAS is a free MCP server for knowledge and memory. Self-hosted catalogue of your skills, agents and MCP servers, searchable by meaning. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** self-hosted, Web, Android, Chrome extension, firefox-extension, API
- **Repository:** https://github.com/bobpanil/vivatlas
- **MCP Registry name:** io.github.bobpanil/vivatlas
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-16

## About

VIVATLAS is for people who collect tools and then cannot find them. Point it at GitHub or Gitea repositories and the links you clip, and it builds a card for each one with a name, a human-readable description, a picture and tags. A recommender can answer a task such as an accessibility audit with three candidates and a sentence on why each fits, or say nothing fits.

It runs on your own hardware as a Docker container, supports several users with private and shared catalogues, and only reads public repositories: it writes nothing back to Git and does not scan private repos. Descriptions and embeddings come from a Gemini key or a local Ollama server, and without AI the search falls back to words. Clippers exist for Chrome, Edge, Brave, Firefox and Android.

The MCP endpoint lets an assistant ask which of your tools does a given job. The server code is under the Business Source License 1.1.

## Features

- **Search by meaning:** Combines full-text and vector search so you can describe a task instead of naming a tool.
- **Automatic cards:** Generates a name, descriptions, tags and a cover image from each repository's README.
- **Recommender:** Suggests three options with a reason each, or reports that nothing fits.
- **Clippers:** Browser extension and Android share sheet for saving links.
- **Multi-user:** Separate private cards and folders plus a shared catalogue.
- **Read-only on Git:** Never writes to repositories or scans private ones.

## Good for

- Rediscover a scraper you starred months ago
- Ask an assistant which of your catalogued tools audits accessibility
- Keep a team catalogue of internal MCP servers and skills
- Track which catalogued repos have gone stale upstream

## Install

### Claude Code (Terminal)

```sh
claude mcp add vivatlas --env SECRET_KEY='<SECRET_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' -- docker run -i --rm -e SECRET_KEY -e GOOGLE_API_KEY ghcr.io/bobpanil/vivatlas:1.0.13
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vivatlas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SECRET_KEY",
        "-e",
        "GOOGLE_API_KEY",
        "ghcr.io/bobpanil/vivatlas:1.0.13"
      ],
      "env": {
        "SECRET_KEY": "<SECRET_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vivatlas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SECRET_KEY",
        "-e",
        "GOOGLE_API_KEY",
        "ghcr.io/bobpanil/vivatlas:1.0.13"
      ],
      "env": {
        "SECRET_KEY": "<SECRET_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "vivatlas": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SECRET_KEY",
        "-e",
        "GOOGLE_API_KEY",
        "ghcr.io/bobpanil/vivatlas:1.0.13"
      ],
      "env": {
        "SECRET_KEY": "<SECRET_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vivatlas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SECRET_KEY",
        "-e",
        "GOOGLE_API_KEY",
        "ghcr.io/bobpanil/vivatlas:1.0.13"
      ],
      "env": {
        "SECRET_KEY": "<SECRET_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vivatlas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SECRET_KEY",
        "-e",
        "GOOGLE_API_KEY",
        "ghcr.io/bobpanil/vivatlas:1.0.13"
      ],
      "env": {
        "SECRET_KEY": "<SECRET_KEY>",
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>"
      }
    }
  }
}
```

## FAQ

### How do I install it?

Run the ghcr.io/bobpanil/vivatlas Docker image on port 8710, then set up the owner at /setup.

### Does it need an AI key?

Optional. A Gemini key or Ollama writes descriptions and embeddings; without it search goes by words.

### Does it change my repositories?

No. It only reads public Git repositories and has no setting to write.

### Is there a demo?

Yes, a public demo whose accounts are deleted after 24 hours and which runs without AI.

### Is VIVATLAS free?

Yes. VIVATLAS is free to use.

### How do I add VIVATLAS to Claude Code?

Run this command in your terminal: claude mcp add vivatlas --env SECRET_KEY='<SECRET_KEY>' --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' -- docker run -i --rm -e SECRET_KEY -e GOOGLE_API_KEY ghcr.io/bobpanil/vivatlas:1.0.13

### What are the best alternatives to VIVATLAS?

The closest alternatives to VIVATLAS are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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