用途
JotDown 是一个基于 Rust 实现的 Model Context Protocol(MCP)服务器,目标是让大语言模型(LLM)能够直接与 Notion 和 mdBook 两类内容系统交互。它面向内容管理与发布工作流,使 LLM 生成的内容可以自动落库到 Notion,或被编译成结构化的 Markdown 书籍。
主要能力
- Notion 集成:LLM 可通过该工具在 Notion 中创建新页面,或更新已有页面,用于存放文章或其他类型的结构化文档。
- mdBook 生成:LLM 可向服务器发送结构化内容,自动生成整本 mdBook,包括章节创建、README.md、SUMMARY.md 管理及各章节 Markdown 文件。
- MCP 支持:借助模型上下文协议在交互过程中保持上下文,使内容创建与更新更智能、更一致。
工具说明
- Notion Page Tool:LLM 用其在 Notion 中创建或更新页面,保存由 LLM 生成的结构化文档。
- mdBook Tool:LLM 用其自动生成 Markdown 书籍,处理多章节创建、结构管理,并生成用于导航的 SUMMARY.md;可基于 LLM 生成的内容生成新书,并自动生成带正确链接的章节。
使用方式
前置条件:
- Rust:需先安装 Rust,可从 rust-lang.org 获取。
- Notion API Token:需要 Notion API token(内部集成密钥)以接入 Notion。
- Claude Desktop 或其他 MCP 客户端(如 Cline、Continue 等):需已安装并配置 Notion 集成 token。
安装步骤:
- 克隆仓库:
git clone https://github.com/Harry-027/JotDown,再cd jotdown。 - 安装依赖:
cargo build --release。 - 安装 mdbook cli(书籍生成必需):
cargo install mdbook。 - Notion 设置:建立与 Notion 工作区连接的内部集成,复制内部集成密钥;在工作区创建一个标题为
Jot It Down的页面,并将其共享给该连接,这是集成正常工作的必要条件。 - 配置 Claude Desktop(或其他 MCP 客户端)的 Notion 集成:在配置文件中加入
"mcpServers": { "Jotdown": { "command": "/path_to_repo/Jotdown/target/release/Jotdown", "args": [], "env": { "NOTION_TOKEN": "your_notion_intergration_token" } } }。 - 重启 Claude Desktop 后即可试用。
集成示例:
- Notion 集成:LLM 向服务器发送请求,指定内容与页面详情,服务器调用 Notion API 创建新页面或更新已有页面。
- mdBook 集成:LLM 向服务器发送结构化内容以生成整本 mdBook,包括章节创建、README.md 与 SUMMARY.md 管理,服务器将内容编译为完整书籍。
适用场景
- 将 LLM 生成的文章或文档自动写入 Notion 页面。
- 基于 LLM 内容自动生成带导航的 Markdown 电子书(mdBook)。
- 在 Claude Desktop、Cline、Continue 等支持 MCP 的客户端中集成上述工作流。
限制
- 必需条件包括 Rust 环境、Notion API token,以及安装 mdbook cli;缺少任一条件可能无法完成对应功能。
- Notion 集成需要预先创建名为
Jot It Down的页面并共享给内部连接。 - 项目未提供除 Notion 与 mdBook 之外的其他功能说明。
- 项目未提供收费、价格等商业信息。
许可与联系
JotDown 采用 MIT 许可证。支持或咨询可发送邮件至 harishmmp@gmail.com。