Notion Anki MCP

🚀 Notion-Anki MCP 服務器

這是一個基於模型上下文協議（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 包管理器。

💻 使用示例

基礎用法

通過 MCP 客戶端（推薦）

1. 配置你的 MCP 客戶端以連接到該服務器。
2. 使用可用工具：
   • search_page：按名稱查找 Notion 頁面。
   • extract_page_content：從頁面中提取問題和答案。
   • generate_flashcards：創建並導入 Anki 卡片。

直接使用 Python

import asyncio
from server import search_notion_page, fetch_page_content, generate_flashcards_gpt

async def create_flashcards(page_name):
    # Search for the page
    page_result = await search_notion_page(page_name)
    if not page_result:
        print(f"Page '{page_name}' not found")
        return
    
    # Extract content
    topics, content = await fetch_page_content(page_result['page_id'])
    
    # Generate and import flashcards
    cards = await generate_flashcards_gpt(page_name, topics, content)
    print(f"Created {len(cards)} flashcards for '{page_name}'")

# Run the example
asyncio.run(create_flashcards("Your Page Name"))

📚 詳細文檔

如何構建你的 Notion 頁面

為使工具有效工作，請按以下方式構建你的 Notion 頁面：

摺疊塊格式

創建摺疊塊，其中：

• 摺疊塊標題 = 你的問題
• 摺疊塊內容 = 答案/解釋

示例結構：

📝 機器學習概念

🔽 什麼是監督學習？
   監督學習是一種機器學習類型，其中...
   - 使用帶標籤的訓練數據
   - 學習從輸入到輸出的映射
   - 示例：分類、迴歸

🔽 分類和迴歸有什麼區別？
   分類預測類別/類，而回歸預測連續值...

支持的內容類型

在摺疊塊內，該工具支持：

• 純文本段落
• 無序列表
• 有序列表
• 基本格式（粗體、斜體等）

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"
}

🔧 技術細節

常見問題

• “未找到頁面”錯誤
  • 確保頁面名稱完全匹配（區分大小寫）。
  • 驗證你的 Notion 集成有權限訪問該頁面。
  • 檢查頁面是否在共享工作區中。
• “AnkiConnect 無響應”錯誤
  • 確保 Anki 桌面應用程序正在運行。
  • 驗證 AnkiConnect 插件已安裝並啟用。
  • 檢查 Anki 未處於複習模式或顯示對話框。
• “OpenAI API 錯誤”錯誤
  • 驗證你的 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 集成。
• 模型上下文協議 提供了 MCP 標準。
• OpenAI 提供了強大的語言模型。

❤️ 為更好的學習和知識留存而打造