Jotdown - MCP Server for Notion Page Creation and mdBook Generation

基本能力

产品定位

JotDown 是一个 MCP 服务器，旨在帮助大型语言模型（LLMs）与 Notion 和 mdBook 集成，实现内容管理和文档生成的自动化。

核心功能

1. Notion 集成：
2. 自动创建或更新 Notion 页面，支持存储结构化内容。
3. mdBook 生成：
4. 生成和管理 Markdown 书籍，包括创建章节、SUMMARY.md 和 README.md 文件。
5. MCP 支持：
6. 通过 Model Context Protocol 维护交互上下文，确保内容创建和更新的智能性与一致性。

适用场景

• 内容管理：自动生成和更新 Notion 页面。
• 文档出版：快速生成 Markdown 书籍，适用于技术文档、教程等。
• 开发效率：简化内容创建和管理的流程。

工具列表

1. Notion Page Tool：
2. 能力：创建或更新 Notion 页面，支持存储 LLM 生成的内容。
3. mdbook Tool：
4. 能力：生成和管理 Markdown 书籍，自动处理章节结构和导航文件。

常见问题解答

• Notion 集成问题：确保已正确配置 Notion API 令牌和共享页面。
• mdBook 生成问题：检查是否已安装 mdbook CLI 工具。

使用教程

使用依赖

1. Rust： bash # 安装 Rust curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. Notion API Token：从 Notion 获取内部集成密钥。
3. Claude Desktop：安装并配置 MCP 客户端（如 Cline 或 Continue）。

安装教程

1. 克隆仓库： bash git clone https://github.com/Harry-027/JotDown cd jotdown
2. 安装依赖： bash cargo build --release
3. 安装 mdbook CLI： bash cargo install mdbook
4. 配置 Notion：
5. 创建共享页面 Jot It Down 并配置集成密钥。
6. 配置 MCP 客户端： json "mcpServers": { "Jotdown": { "command": "/path_to_repo/Jotdown/target/release/Jotdown", "args": [], "env": { "NOTION_TOKEN": "your_notion_intergration_token" } } }
7. 重启客户端并测试。

调试方式

1. 检查 Notion 集成：
2. 确保令牌和共享页面配置正确。
3. 检查 mdBook 生成：
4. 运行 mdbook build 验证书籍生成。
5. 查看日志：
6. 检查 MCP 客户端和服务器的日志输出。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。