Jotdown - MCP Server for Notion Page Creation and mdBook Generation

Jotdown - 用于创建 Notion 页面和生成 mdBook 的 MCP 服务

Jotdown 是一种模型上下文协议（MCP）服务，允许大模型（LLM）与 Notion 交互，同时生成 Markdown 书籍。它为大模型提供两种主要工具：

• 👉 Notion 集成：使用大模型生成的内容，在 Notion 中创建或更新页面。
• 👉 Mdbook 生成：根据内容生成 mdbook 并管理其结构。

Jotdown 使大模型能够与这些系统无缝集成，支持各种内容管理和发布工作流。

---

经 MCPHub 认证

• 👉 JotDown

---

功能

• 🌿 Notion 集成：自动使用大模型生成的内容创建或更新 Notion 页面。
• 🌿 Mdbook 生成：直接根据内容创建和管理 mdbook，包括生成 SUMMARY.md、README.md 和各章节 Markdown 文件等必要文件。
• 🌿 MCP 支持：利用模型上下文协议在交互过程中保持上下文，从而实现更智能、一致的内容创建和更新。

---

Jotdown 提供的工具

1. Notion 页面工具

大模型可以使用 Notion 工具在 Notion 中创建或更新页面，以便直接在 Notion 中存储文章等结构化内容或其他类型的文档。

示例：

• 在 Notion 中创建一个包含大模型生成内容的新页面。
• 使用新信息更新现有的 Notion 页面。

2. mdbook 工具

使用 mdbook 工具，大模型可以自动生成 Markdown 书籍，处理多个章节的创建、结构管理，并添加用于导航的 SUMMARY.md 文件。

示例：

• 根据大模型生成的内容创建一本新书。
• 自动生成章节，并在 SUMMARY.md 中添加正确的链接。

---

安装

先决条件

• Rust：请确保已安装 Rust。可从 rust-lang.org 安装。
• Notion API 令牌：你需要一个 Notion API 令牌（internal integration secret）才能与 Notion 集成。
• Claude Desktop：请确保已安装 Claude 桌面应用或其他 MCP 客户端（Cline、Continue 等），并配置好 Notion 集成令牌。

安装步骤

1. 克隆仓库：

   git clone https://github.com/Harry-027/JotDown
   cd jotdown
   

2. 安装依赖：

   cargo build --release
   

3. 安装 mdbook cli（生成书籍功能需要此工具）：

   cargo install mdbook
   

4. 设置 Notion：

   • 设置 Notion 连接（可访问 Notion 工作区的内部集成），并复制 internal intergration secret 以备后用。
   • 在工作区中创建一个标题为 Jot It Down 的页面，并将其分享给你的连接。集成功能需要此操作。

5. 配置 Claude 桌面应用（或其他 MCP 客户端）的配置文件（用于 Notion 集成）：

     "mcpServers": {
           "Jotdown": {
               "command": "/path_to_repo/Jotdown/target/release/Jotdown",
               "args": [],
               "env": {
                   "NOTION_TOKEN": "your_notion_intergration_token"
               }
           }
     }
   

6. 重启 Claude 桌面应用并试用！

---

Notion 集成示例：

• 要创建或更新 Notion 页面，大模型会向服务发送请求，指定内容和页面详情。随后，服务会与 Notion API 交互，以创建新页面或更新现有页面。

Mdbook 集成示例：

• 大模型可以向服务发送结构化内容来创建整本 mdbook，包括章节创建、README.md 和 SUMMARY.md 管理。服务会将内容编译成一本完整的书。

---

🧑‍💻 演示

Notion 演示 -

MdBook 演示 -

MdBook 截图 -

---

🧑‍💻 参与贡献

欢迎提交问题或拉取请求。

---

📜 许可证

Jotdown 基于 MIT License 授权。详情请参阅 LICENSE 文件。

---

📧 联系方式

如需支持或有任何咨询，请发送邮件至 [email protected]。