AI导哈

知识库AI连接桥

通过Model Context Protocol (MCP)将RemNote知识库与AI助手（如Claude、GPT等）双向连接，实现AI对知识库的读写操作。

  • by AlexHagemeister
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 AlexHagemeister/remnote-mcp-bridge

使用说明

RemNote MCP桥

通过以下方式将RemNote连接到AI助手（Claude、GPT等） **模型上下文协议（MCP）**该项目实现了双向通信，允许AI直接读写您的RemNote知识库。

什么是MCP？

模型上下文协议 是Anthropic的开放标准，允许AI助手与外部工具和数据源进行交互。有了这座桥，你的人工智能助手就成为了真正的PKM伙伴。

特性

核心能力

  • 创建笔记 -AI可以创建带有标题、内容和标签的新笔记
  • 搜索知识库 -在所有Rems中进行全文搜索
  • 阅读笔记 -访问笔记内容和分层子项
  • 更新备注 -修改现有笔记、附加内容、管理标签
  • 日报 -将条目添加到今天的每日文档中

插件功能

  • 自动标记 -自动标记通过MCP创建的笔记（可配置）
  • 会话统计 -跟踪创建/更新/日记条目/搜索
  • 行为历史 -查看带有时间戳的最近10个MCP操作
  • 可配置设置 -通过RemNote设置自定义行为
  • 实时状态 -侧边栏小部件中的连接状态指示器

⚠️ 重要提示：部署自己的服务器

安全通知： 每个用户都必须部署自己的MCP服务器实例。不要在用户之间共享服务器URL，因为这可能会将您的RemNote数据暴露给他人。

快速启动选项

方案A：地方发展 （建议用于测试）

  • 服务器在您的计算机上运行
  • 无需云部署
  • 仅适用于Claude Desktop

选项B：云部署 （Claude Mobile需要）

  • 部署到铁路、渲染或类似对象
  • 启用Claude Mobile访问
  • 每个用户都需要自己的部署

看 服务器/README.md 了解详细的部署说明。

安装

1.安装RemNote插件

选项A：市场 （一经批准）

  • 在RemNote的插件市场中搜索“MCP Bridge”

方案B：开发模式

git clone https://github.com/AlexHagemeister/remnote-mcp-bridge.git
cd remnote-mcp-bridge
npm install
npm run dev

然后在RemNote中： 设置→ 插件→ 构建→ 从本地主机开发

2.部署您的MCP服务器

⚠️ 关键：为了安全起见，每个用户都必须部署自己的服务器实例。

选项A：本地服务器（最简单）

cd server
npm install
npm run dev

服务器运行于 http://localhost:3002

方案B：铁路部署（适用于克劳德·莫比尔）

  1. 分叉此存储库 转到您的GitHub帐户
  2. 部署到铁路：
    cd server
railway login
railway init
railway up
  3. 注意你的网址： https://your-app-name.up.railway.app

看 服务器/README.md 详细的部署指南，包括Render、Fly.io和Docker。

3.配置RemNote插件

备注： 设置→ 插件→ MCP电桥

集 Websocket服务器URL 致：

  • 当地： ws://127.0.0.1:3002
  • 铁路： wss://your-app-name.up.railway.app

4.配置您的AI助手

适用于克劳德桌面/网络

首选 设置→ 连接器→ 添加自定义连接器

请输入您的服务器URL：

  • 当地： http://localhost:3002/sse
  • 铁路： https://your-app-name.up.railway.app/sse

克劳德·莫比尔

使用您的铁路URL添加自定义连接器：

https://your-app-name.up.railway.app/sse

注： Claude Mobile需要云部署服务器（Railway、Render等）

配置

通过以下方式访问RemNote中的插件设置 设置>插件>MCP网桥:

设置 说明 默认值
自动标记MCP笔记 为所有AI创建的笔记添加标签 true
自动标记名称 AI创建的笔记的标记名称 MCP
日记账条目前缀 日记账条目的前缀 [Claude]
在日记账中添加时间戳 在日记账条目中包含时间 true
WebSocket服务器URL MCP服务器连接URL ws://127.0.0.1:3002
默认父级Rem ID 新笔记的父级（空=根） `

MCP工具可用

连接后，您的AI助手可以使用这些工具：

工具 说明
remnote_create_note 创建一个带有标题、内容、父项和标签的新笔记。可选的 markAs 创建为文档或文件夹。
remnote_search 使用查询和过滤器搜索知识库
remnote_read_note 按ID阅读笔记内容和儿童
remnote_update_note 更新标题、附加内容、添加/删除标签。可选的 markAs 转换为文档或文件夹。
remnote_append_journal 在今天的每日文档中添加条目
remnote_status 检查连接状态

示例用法

一旦所有东西都连接起来，你可以问你的人工智能助手一些事情，比如：

  • “创建关于我们刚刚举行的会议的笔记”
  • “在我的笔记中搜索有关项目X的信息”
  • “添加日记条目：今天完成了MCP集成！”
  • “查找我标记为“想法”的所有笔记并对其进行总结”
  • “用这本新书更新我的‘阅读清单’笔记”

建筑

┌─────────────────┐     SSE/HTTP       ┌─────────────────┐
│   Claude App    │◄──────────────────►│   MCP Server    │
│ (Mobile/Desktop)│    /sse endpoint   │ (server/ dir)   │
└─────────────────┘                    └────────┬────────┘
                                               │
                                          WebSocket
                                          wss://:PORT
                                               │
                                       ┌───────▼────────┐
                                       │ RemNote Plugin │
                                       │  (In browser)  │
                                       └───────┬────────┘
                                               │
                                          Plugin SDK
                                               │
                                       ┌───────▼────────┐
                                       │    RemNote     │
                                       │ Knowledge Base │
                                       └────────────────┘

MCP服务器桥接两个协议：

  • SSE（服务器发送事件） 克劳德客户
  • 双向通信 适用于浏览器中运行的RemNote插件

发展

插件（在RemNote中运行）

# install dependencies
npm install

# run in dev mode (hot reload)
npm run dev

# build for production
npm run build
# output: PluginZip.zip

服务器（在铁路或本地运行）

cd server

# install dependencies
npm install

# run in dev mode
npm run dev

# build
npm run build

# run production
npm start

故障排除

插件显示“已断开连接”

  • 确保您的MCP服务器正在运行（本地或已部署）
  • 检查RemNote插件设置中的WebSocket URL：
    • 当地： ws://127.0.0.1:3002
    • 铁路： wss://your-app-name.up.railway.app （使用您的部署URL）
  • 验证您的服务器是否可访问： curl https://your-app-name.up.railway.app/health
  • 在RemNote的开发者控制台（Cmd+Option+I）中查找错误

“无效事件setCustomCSS”错误

  • 这些是开发模式的外观错误
  • 它们不会影响功能
  • 它们不会出现在生产版本中

注释未出现

  • 检查是否设置了默认父ID（可能是在特定Rem下创建的）
  • 验证自动标记设置没有过滤您的视图

数据隐私

重要提示： 此插件将您的RemNote数据发送到外部服务。

当你使用这个插件时：

  • RemNote数据已传输 到您配置的MCP服务器（本地或远程）
  • MCP服务器转发 将此数据发送到您连接的AI助手（Claude、GPT等）
  • 数据包括 根据调用的工具记录标题、内容、标签和层次结构

发送了哪些数据？

该插件仅在以下情况下发送数据：

  1. 您显式调用MCP工具（创建、搜索、读取、更新注释）
  2. AI助手请求访问您的RemNote数据

数据流：

RemNote (your browser) → MCP Server (your deployment) → AI Assistant (Claude/GPT)

安全建议：

  • 部署自己的服务器 -从不与其他用户共享服务器URL
  • 每个用户都需要自己的部署 -共享服务器将数据暴露给其他人
  • 审查工具调用 在允许AI执行它们之前
  • 使用本地服务器 最高安全性（无互联网传输）
  • 未存储任何数据 通过MCP服务器-它只桥接连接
  • 保持服务器URL私有 -将其视为密码

为什么每个用户都需要自己的服务器：

MCP服务器充当RemNote和AI助手之间的桥梁。如果多个用户连接到同一台服务器，他们的数据可能会混合或相互暴露。 始终部署自己的实例。

通过使用此插件，您确认您的RemNote数据将被传输到您配置的服务。

贡献

欢迎投稿！请随时提交拉取请求。

  1. 克隆该仓库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

MIT许可证-请参阅 许可证 了解详情。

链接

资源 URL
GitHub回购 https://github.com/AlexHagemeister/remnote-mcp-bridge
插件文件（GitHub页面） https://alexhagemeister.github.io/remnote-mcp-bridge/
服务器部署指南 服务器/README.md

致谢

与克劳德一起制作 -这个插件是与Claude AI合作开发的。

相关 MCP