mcpField
C
claude-desktop-bridge

claude-desktop-bridge

本地服务
github.com/KiMiGuel记忆与知识03 周前更新
代码仓库

关于 claude-desktop-bridge

claude-desktop-bridge 是本地 MCP 服务，为 Claude Desktop 的 Chat 和 Code 提供共享的持久化笔记库。笔记可搜索并按项目整理，服务不会发起网络请求。

主要功能

  1. 01Chat 与 Code 共享笔记
  2. 02保存、读取、搜索、更新和删除笔记
  3. 03按项目或标签筛选笔记
  4. 04本地 SQLite 存储

适用场景

  1. 01切换 Desktop 标签页时保留上下文
  2. 02按主题或项目查找笔记
  3. 03为多个代码库分别整理笔记

MCP 相关

通过 MCP 扩展向 Claude Desktop 提供五种笔记管理工具。单独使用 Claude CLI 时，也可显式注册并访问同一本地笔记库。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "kimiguel-claude-desktop-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-desktop-bridge"
      ],
      "env": {
        "VAULT_DIR": "<VAULT_DIR>"
      }
    }
  }
}
启动命令npx -y claude-desktop-bridge
需要配置的环境变量
VAULT_DIRDirectory for the local SQLite vault database (defaults to ~/.claude-bridge)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmclaude-desktop-bridge1.0.0

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
tagsarray否用于之后筛选的可选标签
titlestring是笔记的简短标题
contentstring是笔记正文
projectstring否此笔记所属的项目／仓库（如有）

详细介绍

Claude-Desktop-Bridge

本地 MCP 服务，为 Claude Desktop 的 Chat 和 Code 标签页提供共享且持久的笔记库。Claude 通过五个工具——save_note、get_notes、search_notes、update_note、delete_note——按需提取内容，无需在每次切换标签页后重新推导上下文。

安装

  1. 从 Releases 下载 claude-desktop-bridge.mcpb。
  2. 将其拖到 Claude Desktop 窗口中，或依次点击 Settings → Extensions → Advanced settings → Install Extension…
  3. 无需配置。笔记库存放在 ~/.claude-bridge/vault.db。

工具

工具描述
save_note保存新笔记（标题、内容、可选标签、可选项目）
get_notes按 ID、标签或项目检索笔记，按时间从近到远排序
search_notes对笔记标题和内容进行全文搜索
update_note更新现有笔记的标题、内容、标签或项目
delete_note按 ID 永久删除笔记

笔记带有可选的 project 字段，因此多个代码库中的工作可以彼此隔离——每个项目的笔记都可独立筛选。

使用方法

在任一标签页中正常交流即可——Claude 会在适当时自行调用工具。你无需手动调用任何工具。

  • 主动处理，但不会自动记录所有内容。 Claude 会自行判断哪些内容值得保存或搜索，而不是记录每条消息。想保留某些内容时，请说“记住这个，之后要用”。
  • 跨代码库工作时按项目添加标签，这样在一个仓库的上下文中搜索时，不会出现其他项目的笔记。
  • Chat 标签页中的“Projects”不会自动关联到 Code 标签页的文件夹。 请将以下内容添加到该 Project 的 Custom Instructions 中：“This project corresponds to the my-repo codebase; use Claude-Desktop-Bridge with project: 'my-repo'.”

适用范围

使用场景是否开箱即用？
Claude Desktop — Chat 标签页✅ 是
Claude Desktop — Code 标签页（本地会话）✅ 是
独立的 claude CLI（终端中使用，无需 Desktop）⚠️ 还需额外一步
Claude Code 网页版 / 云端会话❌ 不可用（仅限本地服务）

独立的 CLI 不会读取 Desktop 的扩展配置。请显式注册：

# macOS or WSL — imports every MCP server Desktop has configured
claude mcp add-from-claude-desktop

# Any platform, including Linux — register this repo's built server:
claude mcp add --scope user claude-desktop-bridge -- node /path/to/claude-desktop-bridge/server/index.js

--scope user 会使其在每个终端项目中都可用。它会读取与 Desktop 扩展相同的 ~/.claude-bridge/vault.db，因此笔记可以共享。

想减少笔记消耗的 token 吗？ cdb-companion 会在内容传入 save_note/update_note 前对其进行压缩。

从源代码构建

npm install
npm run build   # bundles src/index.ts -> server/index.js
npm run pack     # produces claude-desktop-bridge.mcpb

需要 Node.js 22+（内置 node:sqlite）。扩展由 Claude Desktop 自带的 Node 运行时运行，最终用户无需安装 Node。检查项：npm ci + npm test（参见 .github/workflows/npm-project.yml）。

配置

  • 笔记库 → ~/.claude-bridge/vault.db（本地 SQLite）。卸载扩展不会删除该文件；笔记会一直保留，直到通过 delete_note 删除或移除该文件。
  • 网络 → 无。没有服务端组件，不发送外部请求，也不进行分析或遥测。

参与贡献

提交 PR 前，请先创建 issue 进行讨论。请编辑 src/index.ts——server/index.js 是生成文件。PR 必须通过 npm ci + npm test。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。