Jotdown

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

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

• 👉 Notion 集成：借助 LLM 生成的内容，在 Notion 中创建或更新页面。
• 👉 Mdbook 生成：从内容里生成 Markdown 书籍，并对其结构进行管理。

通过 Jotdown，LLMs 能够无缝集成到这些系统中，实现多样化的内容管理和发布工作流程。

✨ 主要特性

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

📦 安装指南

先决条件

• 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 仓库以获取支持。