🚧 正在开发中-尚未准备好生产🚧
警告: 该项目正在积极开发中,尚未准备好投入生产使用。 API、数据库查询和功能可能会更改,恕不另行通知。
______________________________________________________________________
Bytefrost乔普林MCP
A. 模型上下文协议(MCP) 服务器,让人工智能助手(克劳德等)通过您的自托管Joplin服务器直接访问您的Joplin笔记。
这是什么?
Bytefrost Joplin MCP让您:
- 🔍 搜索 你用自然语言写的乔普林笔记
- 📖 阅读 笔记、笔记本和标签
- ✏️ 创建和编辑 直接从您的AI助手中记录
- 🏷️ 组织 带有标签和笔记本
为什么要直接访问数据库?
Joplin现有的API有局限性:
- REST API: 仅在桌面客户端上可用(需要运行应用程序)
- 服务器API: 设计用于同步协议,而不是直接数据访问
- 客户端依赖关系: 大多数集成都需要运行Joplin应用程序
此MCP直接连接到PostgreSQL数据库,实现真正的服务器端自动化,无需任何客户端依赖。
目标受众
这个项目适合你,如果你:
- ✅ 跑a 自托管Joplin服务器 使用PostgreSQL
- ✅ 希望通过MCP将您的笔记与AI助手集成
- ✅ 熟悉Docker和终端
不支持:
- ❌ 乔普林云(无数据库访问权限)
- ❌ 仅限本地Joplin桌面(使用SQLite,不使用PostgreSQL)
- ❌ 仅限移动应用程序
需求
- 乔普林服务器≥2.6.0(自托管)
- PostgreSQL数据库(附带Joplin Server docker compose)
- Docker(推荐)或Python 3.11+运行时
安装
🚧 *即将推出*
配置
🚧 *即将推出*
用法
🚧 *即将推出*
文档
看 docs/DEVELOPMENT.md 有关以下内容的技术文档:
- 数据库架构和
items表结构 - 项目类型(笔记、笔记本、标签等)
- JSON内容格式解析
- SQL查询示例
- 同步协议注意事项
许可证
MIT许可证-请参阅 许可证
贡献
这个项目是开源的,欢迎投稿!由于该项目仍处于早期开发阶段,请在开始更大的更改之前打开一个问题。
______________________________________________________________________
由...制作☕ 通过 Bytefrost
