AI导哈

Notion Markdown同步工具

NotionMCP Light是一个通过Notion API实现Markdown文件与Notion页面双向同步的非官方MCP服务器，支持无令牌直接操作。

  • by karaage0703
  • Python
  • 本地部署
  • 49 星标
  • 更新于
在 GitHub 查看 karaage0703/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在许可证下公开。了解更多信息许可证请参见文件。

相关 MCP