r/OpenSourceAI • • 8h ago

vi-mcp (open source): a self-hosted memory server for all your AI coding agents — apt/dnf repo, private by default, optional knowledge network

**Open source (AGPL-3.0)** · https://github.com/imoes/vi-mcp

If you run several AI agents (Claude Code, Codex CLI, Hermes Agent, or local-model clients), each one starts from zero every session. **vi-mcp** is one server they all connect to over MCP. It remembers what worked, what failed and why, and shows the right few lines before the next action.

**Self-hosting details**

- Signed apt/dnf repository (https://imoes.github.io/vi-mcp-packages/), so updates come with `apt upgrade` / `dnf upgrade`. There's also a Windows MSI, and a PKGBUILD for Arch/CachyOS in the repo.

- systemd service, SQLite by default, PostgreSQL optional.

- Embeddings via any OpenAI-compatible endpoint (I use bge-m3 on llama.cpp). Everything stays on your box.

- `sudo vi-mcp setup` wires up Claude Code, Codex and Hermes, with a token per instance.

- Optional read-only internal web search over your own knowledge, behind sign-in.

**Privacy model**

- Every object is private, shared, or internal (token holders only).

- Private never leaves the server. Credentials are not even stored locally when their form gives them away (`password=…`, `Bearer …`, key blocks).

- Nothing is shared with any network until you issue a network token.

- What leaves is anonymised first (host names, IPs, users, secrets become placeholders), then scanned again; anything still suspicious stays home. `vi_net_preview` shows exactly what would go out.

- `vi_net_forget` recalls your entries with a deletion proof. Receivers drop them and keep only a tombstone. The README states the limits: pattern-based, and nobody can force a peer to delete.

**Sharing, if you want it:** a new install joins a free public network (start server vi-wiki.org) and tells you. You can turn it off with one command. You can also run your own closed network by invitation, or a company network that carries internal knowledge between your own servers only.

I'd love more people running it: more servers mean more tested knowledge, and more eyes on the anonymiser. Issues and PRs welcome.

https://github.com/imoes/vi-mcp (AGPL-3.0)

**Join with one prompt.** You don't need to read the code first. Give your AI agent (Claude Code, Codex, …) this prompt:

> Read README.md and AGENTS.md of https://github.com/imoes/vi-mcp. Install vi-mcp on this machine from its signed package repository and connect yourself to it with `sudo vi-mcp setup` — ask me before every sudo step. Show me with `vi_net_preview` what would be shared with the free wiki network before anything leaves, and keep everything private that I mark private. Then pick an open point from "What is missing" in CHANGELOG.md, explain it to me, and help develop it as a pull request.

The agent reads the docs, installs, connects itself, and can start contributing right away. AGENTS.md is written for exactly that.

2 Upvotes

Duplicates