Jotdown - MCP Server for Notion Page Creation and mdBook Generation

Jotdown - Notion ページの作成と mdBook の生成を行う MCP サーバー

Jotdown は、LLM が Notion と連携し、Markdown ブックも生成できる Model Context Protocol（MCP）サーバーです。LLM 向けに、主に次の 2 つのツールを提供します。

• 👉 Notion 連携：LLM が生成したコンテンツを使って、Notion のページを作成または更新します。
• 👉 Mdbook 生成：コンテンツから mdbook を生成し、構成を管理します。

Jotdown を使用すると、LLM はさまざまなコンテンツ管理や公開のワークフローで、これらのシステムとシームレスに連携できます。

---

MCPHub 認定

• 👉 JotDown

---

機能

• 🌿 Notion 連携：LLM が生成したコンテンツを使って、Notion のページを自動的に作成または更新します。
• 🌿 Mdbook 生成：コンテンツから直接 mdbook を作成・管理します。SUMMARY.md、README.md、個々の章の Markdown ファイルなど、必要なファイルの生成にも対応します。
• 🌿 MCP サポート：Model Context Protocol を活用してやり取りのコンテキストを維持し、よりインテリジェントで一貫性のあるコンテンツの作成や更新を可能にします。

---

Jotdown が提供するツール

1. Notion ページツール

LLM は Notion ツールを使って Notion 内のページを作成または更新できます。記事などの構造化されたコンテンツや、その他の種類の文書を Notion に直接保存できます。

例：

• LLM が生成したコンテンツを使って、Notion に新しいページを作成します。
• 既存の Notion ページを新しい情報で更新します。

2. mdbook ツール

mdbook ツールを使用すると、LLM は Markdown ブックを自動的に生成できます。複数の章の作成や構成の管理に対応し、ナビゲーション用の SUMMARY.md ファイルも追加します。

例：

• LLM が生成したコンテンツをもとに、新しいブックを生成します。
• SUMMARY.md に適切なリンクを含む章を自動的に生成します。

---

インストール

前提条件

• Rust：Rust がインストールされていることを確認してください。rust-lang.org からインストールできます。
• Notion API トークン：Notion と連携するには、Notion API トークン（internal integration secret）が必要です。
• Claude Desktop：Claude desktop、または Notion 連携トークンを設定したその他の MCP クライアント（Cline、Continue など）がインストールされ、設定済みであることを確認してください。

インストール手順

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 は構造化されたコンテンツをサーバーに送信して、章の作成、README.md、SUMMARY.md の管理などを含む mdbook 全体を作成できます。サーバーはコンテンツをコンパイルして、完成した書籍を生成します。

---

🧑‍💻 デモ

Notion のデモ -

MdBook のデモ -

MdBook のスクリーンショット -

---

🧑‍💻 コントリビューション

お気軽にイシューを作成するか、プルリクエストを送信してください。

---

📜 ライセンス

Jotdown は MIT License のもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。

---

📧 お問い合わせ

サポートやお問い合わせは、[email protected] までご連絡ください。