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

Jotdown 是一个模型上下文协议 (MCP) 服务器，允许大型语言模型 (LLM) 与 Notion 交互，并生成 Markdown Books。 它为 LLM 提供了两个主要工具：

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

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

---

特性

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

---

Jotdown 提供的工具

1. Notion 页面工具

LLM 可以使用 Notion 工具在 Notion 中创建或更新页面，从而允许它们将结构化内容（如文章或任何其他类型的文档）直接存储在 Notion 中。

示例：

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

2. mdbook 工具

借助 mdbook 工具，LLM 可以自动生成 markdown 书籍，处理多个章节的创建，管理结构，并添加一个 SUMMARY.md 文件以进行导航。

示例：

• 基于 LLM 生成的内容生成一本新书。
• 自动生成章节，并在 SUMMARY.md 中添加正确的链接。

---

安装

前提条件

• Rust：确保您已安装 Rust。 您可以从 rust-lang.org 安装它。
• Notion API Token：您需要一个 Notion API 令牌（internal integration secret）才能与 Notion 集成。
• Claude Desktop：确保您已安装 Claude desktop 或任何其他 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 desktop（或任何其他 MCP 客户端）配置文件（用于 Notion 集成）：

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

6. 重新启动 Claude desktop 并尝试一下！

---

Notion 集成示例：

• 要创建或更新 Notion 页面，LLM 会向服务器发送一个请求，指定内容和页面详细信息。 然后，服务器与 Notion API 交互，以创建新页面或更新现有页面。

Mdbook 集成示例：

• LLM 可以将结构化内容发送到服务器，以创建一个完整的 mdbook，包括章节创建、README.md 和 SUMMARY.md 管理。 服务器将内容编译成一本完整的书。

---

🧑‍💻 演示

Notion 演示 -

MdBook 演示 -

MdBook 截图 -

---

🧑‍💻 贡献

欢迎提出问题或提交 pull request。

---

📜 许可证

Jotdown 在 MIT 许可证 下获得许可。 有关详细信息，请参见 LICENSE 文件。

---

📧 联系方式

如需支持或咨询，请通过 harishmmp@gmail.com 与我们联系。