Vault — 一个微型个人MCP服务器

笔记 + 书签，存储在单个 SQLite 文件中，通过 5 个工具暴露给 Claude： add_note、add_bookmark、search_notes、list_notes、delete_note。

1. 安装 uv（一次性操作）

打开 PowerShell 并运行：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

完成后关闭并重新打开终端，以便 uv 出现在 PATH 中。

Related MCP server: MCP Notes Server

2. 设置项目

将此文件夹解压到某个永久位置，例如 C:\Users\<你>\mcp-vault。然后在该文件夹内运行：

cd C:\Users\<you>\mcp-vault
uv sync

这将创建一个虚拟环境并安装 fastmcp。

3. 独立测试（在接入 Claude Desktop 之前）

uv run fastmcp dev server.py

这会在浏览器中打开 MCP Inspector。点击 "Tools" 标签页，尝试调用 add_note 并输入一些文本，然后调用 list_notes——你应该能看到刚才添加的内容。满意后按 Ctrl+C 停止。

4. 接入 Claude Desktop

打开（或创建）以下文件：

%APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 下添加一个 vault 条目。如果文件中已有其他服务器，只需将此键与它们并列添加——不要替换整个文件。

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

将 C:\\Users\\<你>\\mcp-vault 替换为你实际存放文件夹的位置——请使用如所示的双反斜杠。

5. 重启 Claude Desktop

完全退出（右键单击系统托盘图标 → 退出，而非仅关闭窗口）并重新打开。在聊天框中查找工具图标——点击它，你应该能看到列出的 5 个 vault 工具。

6. 尝试使用

• "保存一条笔记：更新护照，标签为 todo"

• "保存此链接：https://example.com，标题为 Example，标签为 reference"

• "我保存了什么标签为 todo 的内容？"

• "搜索我的笔记中关于 passport 的内容"

• "删除笔记 1"

你的数据存储在 server.py 旁边的 vault.db 中——它就是一个 SQLite 文件，因此你可以用任何 SQLite 浏览器直接打开查看。

截图

备注

• 每个工具的文档字符串是 Claude 决定何时调用它的依据——如果你重命名或重新调整工具用途，请务必保持文档字符串准确，这就是整个接口。

• 如果 Claude Desktop 没有加载该服务器，请检查 %APPDATA%\Claude\logs\ 中的错误——通常是由于配置中的路径错误。