Notion Anki MCP

🚀 Notion-Anki MCP Server

このツールは、Model Context Protocol (MCP) サーバーであり、Notion ページから自動的に Anki のフラッシュカードを生成します。OpenAI の API を使用して、Notion のトグルブロックから質問と回答を抽出し、構造化された Anki カードに変換し、AnkiConnect を介してリアルタイムでインポートします。

🚀 クイックスタート

1. リポジトリをクローンする

git clone https://github.com/yourusername/notion-anki-mcp.git
cd notion-anki-mcp

2. 依存関係をインストールする

pip install -r requirements.txt

3. 環境を設定する

cp .env.example .env

.env ファイルを編集し、API キーを設定します。

NOTION_API_KEY=your_notion_api_key_here
OPENAI_API_KEY=your_openai_api_key_here

4. MCP サーバーを起動する

python server.py

✨ 主な機能

• Notion 統合: 公式 API を介して Notion ページからコンテンツを抽出します。
• スマートパース: トグルブロックを質問と回答のペアとして認識します。
• AI 強化: OpenAI を使用して、フラッシュカードの品質を向上させます。
• リアルタイムインポート: AnkiConnect を介して自動的に Anki にカードを追加します。
• MCP プロトコル: Claude Desktop などの MCP 互換クライアントと連携します。

📦 インストール

このプロジェクトをセットアップする前に、以下のものが必要です。

1. Notion API アクセス

   • Notion 統合を作成します。
   • 統合設定から API キーを取得します。

2. OpenAI API アクセス

   • OpenAI APIにサインアップします。
   • 十分なクレジットを持つ API キーを作成します。

3. Anki のセットアップ

   • Anki デスクトップアプリケーションをインストールします。
   • AnkiConnect アドオンをインストールします。
   • フラッシュカード生成中は Anki を起動したままにしておきます。

4. Python 環境

   • Python 3.8 以上
   • pip パッケージマネージャー

💻 使用例

基本的な使用法

import asyncio
from server import search_notion_page, fetch_page_content, generate_flashcards_gpt

async def create_flashcards(page_name):
    # ページを検索する
    page_result = await search_notion_page(page_name)
    if not page_result:
        print(f"ページ '{page_name}' が見つかりませんでした。")
        return
    
    # コンテンツを抽出する
    topics, content = await fetch_page_content(page_result['page_id'])
    
    # フラッシュカードを生成してインポートする
    cards = await generate_flashcards_gpt(page_name, topics, content)
    print(f"ページ '{page_name}' の {len(cards)} 枚のフラッシュカードを作成しました。")

# サンプルを実行する
asyncio.run(create_flashcards("Your Page Name"))

高度な使用法

MCP クライアントを使用することで、以下のような操作が可能です。

1. MCP クライアントをこのサーバーに接続するように設定します。
2. 利用可能なツールを使用します。
   • search_page: 名前で Notion ページを検索します。
   • extract_page_content: ページから質問と回答を抽出します。
   • generate_flashcards: Anki カードを作成してインポートします。

📚 ドキュメント

Notion ページの構造

このツールを効果的に使用するには、Notion ページを以下のように構造化してください。

トグルブロック形式

トグルブロックを作成し、以下のように設定します。

• トグルタイトル = 質問
• トグルコンテンツ = 回答/説明

例:

📝 Machine Learning Concepts

🔽 What is supervised learning?
   Supervised learning is a type of machine learning where...
   - Uses labeled training data
   - Learns mapping from inputs to outputs
   - Examples: classification, regression

🔽 What's the difference between classification and regression?
   Classification predicts categories/classes while regression predicts continuous values...

サポートされるコンテンツタイプ

トグルブロック内では、以下のコンテンツタイプがサポートされています。

• プレーンテキストの段落
• 箇条書きリスト
• 番号付きリスト
• 基本的な書式設定（太字、斜体など）

📚 API ドキュメント

MCP ツール

search_page

名前で Notion ページを検索します。

パラメータ:

• page_name (文字列): 検索する Notion ページのタイトル

戻り値:

{
  "status": "success",
  "page_name": "Page Title",
  "result": {
    "result": "Found",
    "page_id": "page-uuid",
    "link": "https://notion.so/..."
  }
}

extract_page_content

Notion ページから質問と回答を抽出します。

パラメータ:

• page_id (文字列): Notion ページの UUID

戻り値:

{
  "status": "success",
  "topics": ["Topic 1", "Topic 2"],
  "content": {
    "Question 1?": "Answer 1...",
    "Question 2?": "Answer 2..."
  }
}

generate_flashcards

抽出されたコンテンツから Anki のフラッシュカードを作成します。

パラメータ:

• page_name (文字列): Anki デッキの名前
• topics (配列): ページのトピック/見出しのリスト
• content (オブジェクト): 質問と回答のペア

戻り値:

{
  "status": "created",
  "cards": [...],
  "message": "Created flashdeck and cards for 'Page Name' in Anki"
}

🔧 トラブルシューティング

一般的な問題

"Page not found" エラー

• ページ名が正確に一致していることを確認してください（大文字小文字を区別します）。
• Notion 統合がページにアクセスできることを確認してください。
• ページが共有ワークスペースにあることを確認してください。

"AnkiConnect not responding" エラー

• Anki デスクトップが起動していることを確認してください。
• AnkiConnect アドオンがインストールされ、有効になっていることを確認してください。
• Anki がレビューモードやダイアログを表示していないことを確認してください。

"OpenAI API Error" エラー

• OpenAI API キーが正しく、有効であることを確認してください。
• API の使用制限と請求を確認してください。
• GPT - 4 モデルにアクセスできることを確認してください。

空のフラッシュカードが生成される

• Notion ページがトグルブロック形式を使用していることを確認してください。
• トグルブロックにテキストコンテンツが含まれていることを確認してください。
• ページに実際のコンテンツがあり、ヘッダーだけでないことを確認してください。

デバッグモード

server.py を変更してデバッグログを有効にします。

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。

👏 謝辞

• Notion API の優れたドキュメント
• AnkiConnect の Anki 統合機能
• Model Context Protocol の MCP 標準
• OpenAI の強力な言語モデル

❤️ より良い学習と知識の定着のために作成されました