Back to Browse

Vibo MCP Server

Developer ToolsUse Caution4.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

Local-first memory for AI agents: facts with hash-chain provenance, verified recall.

About

Local-first memory for AI agents: facts with hash-chain provenance, verified recall.

Security Report

4.3
Use Caution4.3High Risk

ViBo is a local-first memory server with no shell execution, eval, or hardcoded secrets, and its standard dependencies are reasonable. The main concern is that when the optional cloud mirror is configured, every memory_add is sent to the external BASE_URL, including L3 'secret' facts, which contradicts the README's 'Secrets stay put' claim. Secondary issues include plaintext storage of L3 facts, a hash chain that does not prevent tampering despite the 'nobody edited it' claim, and an unreviewed Python script that depends on a missing module. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

11 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Optional. Local memory works without it; set only to mirror facts to a ViBo cloud account.Required

Environment variable: VIBO_API_KEY

Optional. Storage location for the local memory file (default: ~/.vibo/mcp/memory.json).Optional

Environment variable: VIBO_MEM_FILE

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "vibo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vibo-dev/vibo-mcp@0.3.0"
      ],
      "env": {
        "VIBO_API_KEY": "your-vibo-api-key-here",
        "VIBO_MEM_FILE": "your-vibo-mem-file-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

ViBo MCP Server

Local-first memory for AI agents. Facts live on your machine in one JSON file, each one chained to the previous by hash, so you can prove later where a fact came from and that nobody edited it. Works with any MCP client: Claude Desktop, Claude Code, Cursor, Codex, VS Code, Windsurf.

No account, no key, no network call required.

Install

npm install -g @vibo-dev/vibo-mcp

Client config (Claude Desktop example):

{
  "mcpServers": {
    "vibo": {
      "command": "npx",
      "args": ["-y", "@vibo-dev/vibo-mcp"]
    }
  }
}

Memory is stored in ~/.vibo/mcp/memory.json. Override with VIBO_MEM_FILE (file path) or VIBO_HOME (directory).

Tools

ToolWhat it does
memory_addSave a fact. Deduplicated by label + content. Levels L1 / L2 / L3 (secret).
memory_searchFind facts by words, ranks by relevance. L3 hidden unless include_secrets.
memory_verifyCheck claims: CONFIRMED / CONTRADICTS / PARTIAL / NOT FOUND. Catches wrong numbers.
memory_provenanceVerify the hash chain and list facts with origin and timestamps.
memory_forgetDelete by label or id. Refuses without confirm=true.
memory_usageFacts, tokens stored, average tokens returned per search.
thread_memoryConversation memory: add, context, ask, compress older messages.
web_searchNot in this build — returns an honest "unavailable" instead of failing silently.

Example

memory_add(label="client-anna-prefs", content="Anna orders coffee without sugar, budget 24000 RUB per month")
memory_search(query="what does Anna prefer")
  -> [L1] client-anna-prefs: Anna orders coffee without sugar, budget 24000 RUB per month (0.86)

memory_verify(claims=["Anna budget is 24000 RUB per month", "Anna budget is 99000 RUB per month"])
  -> CONFIRMED "Anna budget is 24000 RUB per month" — memory: client-anna-prefs (L1)
  -> CONTRADICTS "Anna budget is 99000 RUB per month" — memory: client-anna-prefs (L1)

Design

  • Local only by default. The server never phones home. If you set VIBO_API_KEY and VIBO_BASE_URL, facts are mirrored best-effort; failure never breaks a tool call.
  • Provenance built in. Every fact carries hash and prev; memory_provenance recomputes the chain and reports the first break.
  • Secrets stay put. L3 facts are excluded from search results unless explicitly requested.
  • Deterministic recall. Lexical ranking with light stemming, no embeddings, no background "consolidation" that silently rewrites your memory.

Tests

npm run build
python3 tests/smoke.py    # 20 checks over the real stdio protocol

Links

Integrations

Reviews

No reviews yet

Be the first to review this server!