Notion Markdown

🚀 NotionMCP Light 中文版

NotionMCP Light 是一個藉助 Notion API 實現 Markdown 文件與 Notion 頁面同步的 Model Context Protocol (MCP) 服務器，有效解決了官方服務器處理 Markdown 內容時的低效問題，實現了無需令牌的文件與頁面同步。

🚀 快速開始

為了讓您能快速使用 NotionMCP Light，下面將介紹安裝和啟動的步驟。

📦 安裝指南

安裝依賴項

# 若未安裝 uv，請先執行安裝
# pip install uv

# 安裝依賴項
uv sync

設置 Notion API 令牌

1. 在 Notion Developers 創建賬戶並獲取 API 令牌。
2. 將令牌設置為環境變量，或通過 .env 文件進行配置。

# .env 文件示例
NOTION_TOKEN=your_notion_api_token

啟動 MCP 服務器

使用 uv（推薦）

uv run python -m src.main

或者直接指定令牌：

uv run python -m src.main --token your_notion_api_token

普通 Python 環境下

python -m src.main

或直接指定令牌：

python -m src.main --token your_notion_api_token

在 Cline/Cursor 中配置

在 Cline/Cursor 等 AI 工具中使用 NotionMCP Light，請在 mcp_settings.json 文件中添加以下內容：

"notion-mcp-light": {
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/notion-mcp-light",
    "python",
    "-m",
    "src.main"
  ],
  "env": {
    "NOTION_TOKEN": "your_notion_api_token"
  },
  "disabled": false,
  "alwaysAllow": []
}

請將 /path/to/notion-mcp-light 替換為 NotionMCP Light 的實際安裝路徑。

✨ 主要特性

Markdown → Notion

• 將 H1 標題識別為頁面標題。
• 將 Markdown 內容作為新的 Notion 頁面或數據庫條目創建。
• 支持指定目標數據庫 ID。
• 直接調用 Notion API（無需令牌）。

Notion → Markdown

• 將指定的頁面或數據庫條目轉換為 Markdown 格式。
• 輸出時將標題作為 H1 處理。
• 轉換塊結構為 Markdown 格式。
• 具備文件保存功能。

MCP 服務器兼容性

• 遵循 Model Context Protocol (MCP) 規範。
• 支持從 AI 工具（如 Cursor、Cline）進行調用。
• 基於 stdio 的 JSON - RPC 實現。

💻 使用示例

基礎用法

uploadMarkdown

上傳 Markdown 文件並創建 Notion 頁面。

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md"
  }
}