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：铁路部署（适用于克劳德·莫比尔）
- 分叉此存储库 转到您的GitHub帐户
- 部署到铁路：
cd server
railway login
railway init
railway up- 注意你的网址：
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等）
- 数据包括 根据调用的工具记录标题、内容、标签和层次结构
发送了哪些数据？
该插件仅在以下情况下发送数据：
- 您显式调用MCP工具（创建、搜索、读取、更新注释）
- AI助手请求访问您的RemNote数据
数据流：
RemNote (your browser) → MCP Server (your deployment) → AI Assistant (Claude/GPT)安全建议：
- 部署自己的服务器 -从不与其他用户共享服务器URL
- 每个用户都需要自己的部署 -共享服务器将数据暴露给其他人
- 审查工具调用 在允许AI执行它们之前
- 使用本地服务器 最高安全性（无互联网传输）
- 未存储任何数据 通过MCP服务器-它只桥接连接
- 保持服务器URL私有 -将其视为密码
为什么每个用户都需要自己的服务器：
MCP服务器充当RemNote和AI助手之间的桥梁。如果多个用户连接到同一台服务器，他们的数据可能会混合或相互暴露。 始终部署自己的实例。
通过使用此插件，您确认您的RemNote数据将被传输到您配置的服务。
贡献
欢迎投稿！请随时提交拉取请求。
- 克隆该仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
MIT许可证-请参阅 许可证 了解详情。
链接
| 资源 | URL |
|---|---|
| GitHub回购 | https://github.com/AlexHagemeister/remnote-mcp-bridge |
| 插件文件（GitHub页面） | https://alexhagemeister.github.io/remnote-mcp-bridge/ |
| 服务器部署指南 | 服务器/README.md |
致谢
______________________________________________________________________
与克劳德一起制作 -这个插件是与Claude AI合作开发的。