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 倉庫以獲取支持。