ViBo Memory

io.github.vnbochkarev-netizen由 GitHub 账号 vnbochkarev-netizen 发布v0.3.0更新于 Nov 8, 2026

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

发布方自己的服务：Memory.fit

已验证STDIO仅桌面知识与记忆 AI 与机器学习

服务详情

标识符: io.github.vnbochkarev-netizen/vibo-mcp
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 vnbochkarev-netizen。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.vnbochkarev-netizen%2Fvibo-mcp.svg)](https://sourceweft.com/mcp/io.github.vnbochkarev-netizen%2Fvibo-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

面向 AI 助手的本地优先记忆服务器：把事实保存到本机 JSON 文件，可搜索、核验说法并审计哈希链。

可以做什么: 把长期事实保存到本地记忆，按标签与内容去重，并区分 L1/L2/L3 密级
按关键词搜索已存事实并按相关度排序，除非明确要求否则隐藏密级事实
对照记忆核验说法，返回已确认、矛盾、部分匹配或未找到
审计记忆：重算哈希链并列出事实的来源与时间戳
按精确标签或 id 删除事实，需显式确认
查看记忆规模与节省的 token，并维护会话记忆：添加消息、读取上下文、搜索或把旧消息压缩成摘要
适用场景: 适合希望助手跨会话记住关于你、项目、数字或日期的稳定事实、又不想使用云端账号的场景，也适合在复述事实前先对照记忆核验。需要可追溯某条事实来源时同样适用。
运行要求: 以本地 stdio 进程运行，从 npm 包安装，需要 Node.js 和 MCP 客户端。默认无需账号、密钥或网络请求。可选的 VIBO_API_KEY 会把事实镜像到 ViBo 云端账号，VIBO_MEM_FILE 可覆盖默认记忆文件位置。

安装前请注意

记忆写入本地 JSON 文件，保存的内容会留在磁盘上，能访问该文件的人都能读取。删除事实不可恢复，且需要 confirm=true。设置 VIBO_API_KEY 会把事实发送到第三方云服务。标记为密级的事实默认不出现在搜索结果中，但仍保存在本地。

安装

在 SourceWeft 中

打开控制台中的 ViBo Memory，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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

Client config (Claude Desktop example):

json

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

{  "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

Tool	What it does
`memory_add`	Save a fact. Deduplicated by label + content. Levels L1 / L2 / L3 (secret).
`memory_search`	Find facts by words, ranks by relevance. L3 hidden unless `include_secrets`.
`memory_verify`	Check claims: CONFIRMED / CONTRADICTS / PARTIAL / NOT FOUND. Catches wrong numbers.
`memory_provenance`	Verify the hash chain and list facts with origin and timestamps.
`memory_forget`	Delete by label or id. Refuses without `confirm=true`.
`memory_usage`	Facts, tokens stored, average tokens returned per search.
`thread_memory`	Conversation memory: add, context, ask, compress older messages.
`web_search`	Not 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)

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

Integrations

cc-connect (bridge agent CLIs to messengers): docs/cc-connect.md

来源：README.md，提交 98b6781

工具

memory_add

Save a durable fact to local memory on this machine. Deduplicated by label+content.

输入参数label必填levelcontent必填

memory_search

Search local memory for relevant facts. Use before asking the user to repeat something.

输入参数limitquery必填include_secrets

memory_verify

Check factual claims against local memory: CONFIRMED, CONTRADICTS, PARTIAL or NOT FOUND per claim. Use before stating facts about the user, projects, numbers or dates.

输入参数modeclaims必填