Jotdown

🚀 Jotdown - Notion ページ作成 MCP サーバーおよび mdBook 生成器

Jotdown は、モデルコンテキストプロトコル（MCP）サーバーで、大規模言語モデル（LLMs）と Notion を統合し、Markdown ブック を生成することができます。これは、LLMs に以下の 2 つの主要なツールを提供します。

• 👉 Notion 統合：LLM で生成された内容を使って、Notion 内でページを作成または更新します。
• 👉 Mdbook 生成：内容から Markdown ブック を生成し、その構造を管理します。

Jotdown を使用することで、LLMs はこれらのシステムとシームレスに統合され、様々なコンテンツ管理と公開のワークフローを実現できます。

🚀 クイックスタート

Jotdown は、大規模言語モデル（LLMs）と Notion を統合し、Markdown ブックを生成するためのモデルコンテキストプロトコル（MCP）サーバーです。以下に、Jotdown の基本的な使い方を説明します。

✨ 主な機能

• 🌿 Notion 統合：Notion 内で自動的にページを作成または更新します。
• 🌿 Mdbook 生成：内容から直接 Markdown ブック を生成し、管理します。必要なファイル（SUMMARY.md、README.md、各章の Markdown ファイル）を生成します。
• 🌿 MCP サポート：モデルコンテキストプロトコルを利用して、対話中のコンテキストを維持し、よりスマートで一貫性のあるコンテンツの作成と更新を実現します。

📚 ドキュメント

Jotdown が提供するツール

1. Notion ページツール

LLMs は、Notion ツールを使って Notion 内でページを作成または更新できます。これにより、記事やその他のタイプのドキュメントなどの構造化された内容を保存できます。

• 例：
  • LLM で生成された内容を使って、新しい Notion ページを作成する。
  • 既存の Notion ページ内の情報を更新する。

2. mdbook ツール

mdbook ツールを通じて、LLMs は内容から自動的に Markdown ブックを生成できます。章の作成、構造管理を行い、ナビゲーション用の SUMMARY.md ファイルを追加します。

• 例：
  • LLM で生成された内容に基づいて、新しいブックを生成する。
  • 正しいリンク付きの章を自動的に SUMMARY.md に生成する。

📦 インストール

前提条件

• Rust：Rust がインストールされていることを確認してください。rust-lang.org からインストールできます。
• Notion API Token：Notion と統合するために、Notion API トークン（内部統合キー）が必要です。
• 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 リポジトリにアクセスしてサポートを受けてください。