MCP Verified Repo Memory

Verified Repo Memory Banner

验证回购存储器MCP v0.1.2

  

带有引用的防老化存储库内存+即时验证+TTL（存储库范围）。

MCP服务器为AI编码代理提供“安全内存”。内存按存储库进行范围划分，由代码引用支持，并及时进行验证，因此当底层代码发生更改时，代理永远不会收到过时的信息。

快速入门

运行通过 npx:

npx -y @cognitivemyriad/vrm-local --repo /path/to/repo

*（或者，从源代码运行： npm ci && npm run build && node build/index.js --repo /path/to/repo)*

工具

• vrm_store：存储带有文件引用的新内存。
• vrm_search：按关键字搜索候选记忆。
• vrm_retrieve：JIT验证候选者并仅返回有效内存。（代理商的主要工具）
• vrm_list：按状态（有效、过时、丢失）列出内存。
• vrm_forget：手动删除内存。

I/O示例

店铺： 输入：

{
  "subject": "API version sync",
  "fact": "When changing API version, update client/server/docs together.",
  "citations": [{ "path": "src/api.ts", "startLine": 10, "endLine": 15 }]
}

输出：

{
  "stored": true,
  "memoryId": "uuid-...",
  "expiresAt": "2026-03-21T00:00:00Z"
}

检索： 输入：

{ "query": "API version" }

输出：

{
  "query": "API version",
  "valid": [ ... ],
  "stats": { "verified": 1, "validCount": 1 }
}

运作原理

graph TD
    A[Agent] -->|Store Fact + Citation| B(Verified Repo Memory)
    B --> C{Save to Disk}
    C -->|Hash Code Snippet| D[(memories.json)]
    
    A -->|Retrieve Fact| B
    B --> E{JIT Verification}
    E -->|Check File Hash| F{Unchanged or Relocated?}
    F -->|Yes| G[Return VALID Memory]
    F -->|No| H[Return STALE/MISSING]

1. 引用： 每个事实都链接到文件路径和行范围。确切的代码片段被散列并保存。
2. JIT验证： 在将内存返回给代理之前 vrm_retrieve，服务器检查物理文件。如果代码段已移动，则会重新定位引用。如果它已被更改或删除，则内存将标记为STALE/MISSING并从结果中省略。
3. TTL（生存时间）： 记忆会自动过期（默认28天），除非它们被成功检索和使用，这会延长它们的寿命。

数据位置

数据严格受仓库限制，并保存在： /.verified-repo-memory

这包括 memories.json 以及指纹/元数据文件，以防止意外的交叉回购污染。将此目录添加到您的 .gitignore.

安全

• 无网络传输： 这是一个 stdio 仅本地服务器，没有HTTP调用。
• 路径安全： 不允许任何路径遍历(../)在存储库根目录之外，以及访问 .git/ 或 .verified-repo-memory/.
• 无标准污染： 严格的日志记录仅限于 stderr.
• 秘密扫描： 内置启发式秘密扫描以拒绝看起来像API密钥/私钥的内存（可以通过 --no-secret-scan).

与Claude一起使用

克劳德桌面版

要将此服务器添加到Claude Desktop应用程序，请编辑配置文件：

• 在macOS上： ~/Library/Application Support/Claude/claude_desktop_config.json
• 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "verified-repo-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@cognitivemyriad/vrm-local",
        "--repo",
        "/absolute/path/to/your/repo"
      ]
    }
  }
}

克劳德代码

使用以下命令将此服务器添加到Claude代码中 stdio 运输：

claude mcp add mcp-verified-repo-memory --transport stdio -- npx -y @cognitivemyriad/vrm-local

*Windows用户注意事项：* 您可能需要添加前缀 cmd /c 命令：

claude mcp add mcp-verified-repo-memory --transport stdio -- cmd /c npx -y @cognitivemyriad/vrm-local

______________________________________________________________________

出版指南

本节介绍如何将包发布到 NPM 并在 人类MCP注册表 从而使其公开可用。

第一步：发布到NPM

NPM（节点包管理器）是包分发平台。在此处发布允许任何人使用单个命令安装您的工具。

先决条件

• 一 （免费）
• 在您的NPM帐户上启用了双因素身份验证（2FA）
• Node.js已安装在您的计算机上

程序

1.从终端登录NPM：

npm login

浏览器窗口将打开。使用您的NPM帐户登录。出现提示时，从身份验证器应用程序中输入您的2FA代码。

2.发布包：

npm publish --access public

此命令执行以下操作：

• 编译TypeScript→ JavaScript(npm run build)
• 创建一个 .tgz 编译文件的存档
• 将存档上载到 https://registry.npmjs.org/

3.验证发布：

访问 https://www.npmjs.com/package/@cognitivemyriad/vrm-local 在您的浏览器中。您的包裹页面应该出现。

注： 如果需要重新发布，则必须在中递增版本号 package.json 和 server.json 首先(npm version patch).NPM不允许覆盖现有版本。

______________________________________________________________________

步骤2：在Anthropic MCP注册表中注册

这 MCP注册表 是Anthropic的MCP服务器官方目录。在此处注册允许Claude Desktop、Claude Code和其他MCP客户端发现并安装您的服务器。

重要提示： NPM包 必须先发布 （步骤1）。MCP注册表在接受注册之前验证NPM包是否存在。

先决条件

• A. （仅用于身份验证）
• 这 mcp-publisher CLI工具

安装mcp发布器

# macOS (Homebrew)
brew install nicholasgriffintn/tap/mcp-publisher

# Or via npx (no install required)
npx @anthropic-ai/mcp-publisher

程序

1.通过GitHub登录MCP注册表：

mcp-publisher login github

浏览器窗口将打开。使用您的GitHub帐户授权应用程序。

2.发布到MCP注册表：

mcp-publisher publish

此命令读取 server.json 在当前目录中，并向MCP注册表注册服务器。登记处将：

• 验证 server.json 模式
• 检查NPM包是否存在并且可以访问
• 注册服务器元数据（名称、描述、版本、环境变量）

3.验证注册：

访问 https://registry.modelcontextprotocol.io 并搜索您的服务器名称。

注： 一旦版本发布到MCP注册表 不可变的 并且不能改变。要发布更新，请在两者中都增加版本 package.json 和 server.json，先发布到NPM，然后运行 mcp-publisher publish 再一次。

______________________________________________________________________

版本管理

发布新版本时，请始终在中更新版本号 所有三个地点:

# 1. Bump version in package.json
npm version patch  # 0.1.2 → 0.1.3

# 2. Update server.json (both top-level and packages[].version)
# Edit server.json manually to match the new version

# 3. Publish
npm publish --access public
mcp-publisher publish