NotionMCP Light

NotionMCP Light 是一个模型上下文协议 (MCP) 服务器，它使用 Notion API 将 Markdown 文件与 Notion 页面同步。

概述

该项目是为了解决 Notion 官方模型上下文协议 (MCP) 服务器效率低下的问题而开发的，该服务器以块的形式读取和写入 Markdown 并消耗 LLM 令牌。我们提供了一个非官方的 MCP 服务器，允许您直接通过 API 将 Markdown 文件与 Notion 页面/数据库同步，而无需使用令牌。

Related MCP server: Notion MCP Server

功能

Markdown → Notion
- 将 H1 识别为页面标题
- 将 Markdown 内容创建为 Notion 页面或数据库页面
- 可以指定数据库ID
- 直接使用 Notion API（无需令牌）
概念→Markdown
- 将给定页面或数据库中的页面转换为 Markdown 格式。
- 输出标题为 H1
- 将块结构转换为 Markdown
- 保存到文件
MCP 服务器支持
- 符合模型上下文协议 (MCP)
- 提供可从 Cursor 和 Cline 等 AI 工具调用的端点
- 基于 stdio 的 JSON-RPC

安装

安装依赖项

# uvがインストールされていない場合は先にインストール
# pip install uv

# 依存関係のインストール
uv sync

设置 Notion API 令牌

在Notion Developers上创建一个帐户并获取 API 令牌。
您可以在环境变量中设置它，或者创建一个.env文件并设置令牌。

# .envファイルの例
NOTION_TOKEN=your_notion_api_token

如何使用

启动 MCP 服务器

使用紫外线时（推荐）

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 中设置

要将 NotionMCP Light 与 Cline/Cursor 等 AI 工具一起使用，请将以下设置添加到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 的安装目录。

如何使用 MCP 工具

NotionMCP Light 提供以下 MCP 工具：

上传Markdown

上传您的 Markdown 文件并将其创建为 Notion 页面。

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md",
    "database_id": "optional_database_id",
    "page_id": "optional_parent_page_id"
  },
  "id": 1
}

下载Markdown

下载您的 Notion 页面并将其保存为 Markdown 文件。

{
  "jsonrpc": "2.0",
  "method": "downloadMarkdown",
  "params": {
    "page_id": "notion_page_id",
    "output_path": "path/to/output.md"
  },
  "id": 2
}