Notion MCP Light

MCP灯概念

NotionMCP Light单击功能区上Notion API来修改标记元素的显示属性Markdown文件和Notion同步页面Model Context Protocol (MCP)服务器。

概要

此项目包括：Notion公式Model Context Protocol (MCP)以块为单位读写服务器的低效性LLM这是为了解决消耗令牌的问题而开发的。不使用令牌API直接通过Markdown文件和Notion页面/数据库同步MCP提供服务器。

机能

• 降价→ 概念

- H1识别为页面标题 - Markdown了解Notion创建为页面或数据库页面 - 数据库ID可指定 - Notion API直接使用（未使用令牌）

• 概念→ 降价

- 在动态输入提示中单击Markdown转换为格式 - 标题H1作为输出 - 块结构Markdown转换为 - 保存到文件

• MCP服务器支持

- 模型上下文协议（MCP）に準拠 - Cursor屋脊Cline等的AI提供可从工具调用的端点 - JSON-RPC over stdio基本动作

安装

安装相关性

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

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

Notion API Token配置

1. 概念开发者创建帐户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/Claude Code等的AI用编码工具NotionMCP Light中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积MCP进行服务器设置JSON在文件中添加以下设置：

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

/path/to/notion-mcp-light单击功能区上NotionMCP Light安装目录your_notion_api_token单击功能区上Notion的，之API请用令牌替换。

MCP使用工具

NotionMCP Light是以下的MCP提供工具：

uploadMarkdown

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
}

许可证

这个项目MIT在许可证下公开。了解更多信息许可证请参见文件。