Jotdown - Notion 页创建 MCP 服务器及 mdBook 生成器

Jotdown 是一个模型上下文协议（MCP）服务器，允许大型语言模型（LLMs）与 Notion 集成，并生成 Markdown 书籍。它为 LLMs 提供了两个主要工具：

• 👉 Notion 集成：使用 LLM 生成的内容在 Notion 中创建或更新页面。
• 👉 Mdbook 生成：从内容中生成 Markdown Books，并管理其结构。

Jotdown 使 LLMs 能够无缝地与这些系统集成，实现各种内容管理和发布工作流程。

功能

• 🌿 Notion 集成：自动在 Notion 中创建或更新页面。
• 🌿 Mdbook 生成：直接从内容中生成并管理 Markdown Books，包括生成必要的文件如 SUMMARY.md、README.md 和各章节目录的 Markdown 文件。
• 🌿 MCP 支持：利用模型上下文协议维护交互中的上下文，实现更智能和一致的内容创建与更新。

Jotdown 提供的工具

1. Notion 页面工具

LLMs 可以使用 Notion 工具在 Notion 中创建或更新页面，允许它们存储结构化内容，如文章或其他类型的文档。

示例：

• 使用 LLM 生成的内容创建一个新的 Notion 页面。
• 更新现有 Notion 页面中的信息。

2. mdbook 工具

通过 mdbook 工具，LLMs 可以自动从内容中生成 Markdown 书籍，处理章节的创建、结构管理，并添加 SUMMARY.md 文件以便导航。

示例：

• 基于 LLM 生成的内容生成新书。
• 自动生成带有正确链接的章节到 SUMMARY.md 中。

安装

先决条件

• Rust：确保已安装 Rust。可以从 rust-lang.org 进行安装。
• Notion API Token：需要一个 Notion API 令牌（内部集成密钥）以与 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（mdbook 生成所需的工具）：

   cargo install mdbook
   

4. Notion 设置：

   • 配置 Notion 连接（内部集成，访问您的 Notion 工作区），并复制 内部集成密钥 以便后续使用。
   • 在工作区中创建一个标题为 Jot It Down 的页面，并与该连接共享。这是为了使集成正常运行所必需的。

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

     "mcp_configs": {
       "jotdown": {
         "name": "Jotdown Integration",
         "description": "Integration with Jotdown for content creation and management.",
         "config": {
           "notion_token": "your_notion_integration_token_here"
         }
       }
     }
   

6. 启动服务：

   cargo run --release --bin server
   

使用指南

基本命令

• 创建新页面：

  jotdown create-page "页面标题" "页面内容"
  

• 更新现有页面：

  jotdown update-page "页面ID" "新内容"
  

• 生成 Markdown 书籍：

  jotdown generate-book "书籍标题" "章节1标题 章节2标题 ..."
  

示例

创建 Notion 页面

jotdown create-page "我的新页面" "这是我的第一个使用 Jotdown 创建的页面内容。"

更新 Notion 页面

jotdown update-page "page_12345" "更新后的内容"

生成 Markdown 书籍

jotdown generate-book "我的书籍" "第一章 第二章 第三章"

注意事项

• 确保您的 Notion 帐户有足够的权限来创建和编辑页面。
• 在生产环境中使用时，请妥善保管 API 令牌，避免泄露。
• 如果遇到问题，请检查日志文件或访问我们的 GitHub 仓库以获取支持。

以上是 Jotdown 的完整功能介绍及使用指南。希望您能顺利使用该工具实现内容管理和书籍生成！