金大哥 - Notion Markdown MCP 详情

article

README

🚀 NotionMCP Light 中文版

NotionMCP Light 是一个借助 Notion API 实现 Markdown 文件与 Notion 页面同步的 Model Context Protocol (MCP) 服务器，有效解决了官方服务器处理 Markdown 内容时的低效问题，实现了无需令牌的文件与页面同步。

🚀 快速开始

为了让您能快速使用 NotionMCP Light，下面将介绍安装和启动的步骤。

📦 安装指南

安装依赖项

# 若未安装 uv，请先执行安装
# pip install uv

# 安装依赖项
uv sync

设置 Notion API 令牌

在 Notion Developers 创建账户并获取 API 令牌。
将令牌设置为环境变量，或通过 .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"
  }
}

Notion Markdown