NotionMCP Light

NotionMCP Light

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

概述

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

功能

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

安装

安装依赖项

设置 Notion API 令牌

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

如何使用

启动 MCP 服务器

使用紫外线时（推荐）

或者，如果您想直接指定令牌：

如果你使用常规 Python

或者，如果您想直接指定令牌：

在 Cline/Cursor 中设置

要将 NotionMCP Light 与 Cline/Cursor 等 AI 工具一起使用，请将以下设置添加到mcp_settings.json文件：

将/path/to/notion-mcp-light替换为 NotionMCP Light 的安装目录。

如何使用 MCP 工具

NotionMCP Light 提供以下 MCP 工具：

上传Markdown

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

下载Markdown

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

执照

该项目根据 MIT 许可证发布。请参阅LICENSE文件以了解详细信息。