markdown2notion

MCP文档知识

提供方 bonbonsan

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeClineVS Code
查看接入方式

一个将Markdown文件转换为Notion页面的工具,支持格式保留和大文件自动分块处理。

一句话选型结论

按资料字段整理

markdown2notion 属于文档知识类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Markdown转换Python本地部署Notion集成文档管理自动化工具开发效率

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cline,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
markdown2notion当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bonbonsan上游标注的维护方 bonbonsan
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.2 KB
来自项目仓库与上游目录的原文,未做删改

Markdown 2通知

用于将Markdown文件上传到Notion的模型上下文协议(MCP)服务器。此工具允许您轻松地将Markdown文档转换为Notion页面,同时保留格式和结构。

🚀 特性

  • ✅ 将Markdown文件转换为Notion页面 -无缝转换.md文件
  • ✅ 自动处理大文件 -具有100多个块的文件会自动拆分
  • ✅ 基于URL的页面定位 -只需提供一个Notion页面URL作为父级
  • ✅ 支持常见的Markdown元素 -标题、列表、代码块、链接等。
  • ✅ 数据库和页面支持 -上传到数据库或作为子页面
  • ✅ 基于FastMCP框架构建 -易于与MCP客户端集成

📦 安装

  1. 克隆存储库:```bash
    git clone https://github.com/bonbonsan/markdown2notion.git
    cd markdown2notion

2. **安装依赖项:**```bash
pip install -r requirements.txt
# or using pyproject.toml
pip install -e .
  1. 设置您的Notion API令牌:```bash

Create .env file

echo "NOTION_TOKEN=your_notion_api_token_here" > .env


**获取您的Notion API令牌:**

1. 首选 https://www.notion.so/my-integrations
1. 创建新的集成
1. 复制内部集成令牌
1. **重要提示:** 授予对目标页面/数据库的集成访问权限

## 🔧 用法

### 作为MCP服务器(推荐)

#### Cline(VS代码扩展)

1. **设置虚拟环境并安装依赖项:**```bash
cd markdown2notion
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
  1. 打开命令选项板→ Cline: Open MCP Settings.

  2. 添加或更新 cline_mcp_settings.json 与:```json
    {
    "mcpServers": {
    "markdown2notion": {
    "command": "/absolute/path/to/markdown2notion/.venv/bin/python",
    "args": ["/absolute/path/to/markdown2notion/src/server.py"]
    }
    }
    }


**⚠️ 重要提示:**

- 使用 **绝对路径** 对两者 `command` 和 `args`
- 点 `command` 到虚拟环境的Python解释器
- 替换 `/absolute/path/to/markdown2notion` 使用您的实际项目路径
- macOS/Linux示例: `/Users/username/Documents/markdown2notion/.venv/bin/python`
- Windows示例: `C:\Users\username\Documents\markdown2notion\.venv\Scripts\python.exe`

1. **重新启动VS代码** (不仅仅是Cline)保存配置文件后。

#### 克劳德代码(VS代码扩展)

1. **设置虚拟环境并安装依赖项:**```bash
cd markdown2notion
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
  1. 创建工作区设置 在您的项目中:
    创建 .vscode/settings.json 在项目根目录中使用:```json
    {
    "claude.mcpServers": {
    "markdown2notion": {
    "command": "/absolute/path/to/markdown2notion/.venv/bin/python",
    "args": ["/absolute/path/to/markdown2notion/src/server.py"],
    "enabled": true
    }
    }
    }

**⚠️ 重要提示:**

- 使用 **绝对路径** 对两者 `command` 和 `args`
- 点 `command` 到虚拟环境的Python解释器
- 替换 `/absolute/path/to/markdown2notion` 使用您的实际项目路径
- macOS/Linux示例: `/Users/username/Documents/markdown2notion/.venv/bin/python`
- Windows示例: `C:\Users\username\Documents\markdown2notion\.venv\Scripts\python.exe`

#### 克劳德桌面(独立应用程序)

1. **设置虚拟环境并安装依赖项:**```bash
cd markdown2notion
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
  1. 在Claude Desktop中,单击 克劳德→ 设置→ 开发者→ 打开配置文件.

  2. 将以下条目添加到 claude_desktop_config.json (macOS)或您平台上的等效配置文件:```json
    {
    "mcpServers": {
    "markdown2notion": {
    "command": "/absolute/path/to/markdown2notion/.venv/bin/python",
    "args": ["/absolute/path/to/markdown2notion/src/server.py"],
    "enabled": true
    }
    }
    }


**⚠️ 重要提示:**

- 使用 **绝对路径** 对两者 `command` 和 `args`
- 点 `command` 到虚拟环境的Python解释器
- 替换 `/absolute/path/to/markdown2notion` 使用您的实际项目路径
- macOS/Linux示例: `/Users/username/Documents/markdown2notion/.venv/bin/python`
- Windows示例: `C:\Users\username\Documents\markdown2notion\.venv\Scripts\python.exe`

1. **重新启动克劳德桌面** 保存配置文件后。

**注:** 当服务器从此存储库运行时,它会读取 `NOTION_TOKEN` 来自您当地的 `.env` 文件。确保您已创建 `.env` 使用Notion API令牌文件,如安装部分所述。

## 🔍 故障排除

### MCP服务器连接问题

如果CLINE啊Claude Desktop中显示“MCP服务器未连接”错误时:

1. **虚拟化Python检查路径**:确认在配置文件中使用了绝对路径
1. **安装相关性**: `pip install -r requirements.txt`确认在虚拟环境中运行
1. **重新启动应用程序**: VS Code(CLINE使用时)或Claude Desktop完全重新启动
1. **验证路径**:验证配置文件中的路径是否与实际文件位置匹配

### Python直接运行脚本

MCP如果服务器无法正常工作,请选择Python您可以直接运行脚本:```bash
# 仮想環境をアクティベート
source .venv/bin/activate  # macOS/Linux
# または
.venv\Scripts\activate  # Windows

# スクリプトを実行
python -c "
from src.notion_uploader import NotionUploader
uploader = NotionUploader()
page_id = uploader.upload_markdown_file(
filepath='/path/to/your/file.md',
parent_url='https://www.notion.so/your-parent-page-url'
)
print(f'Uploaded! Page ID: {page_id}')
"

直接使用

您也可以直接使用这些组件:```python
from src.notion_uploader import NotionUploader

uploader = NotionUploader()

Using URL (recommended)

page_id = uploader.upload_markdown_file(
filepath="path/to/your/document.md",
parent_url="https://www.notion.so/your-page-url-here"
)

Using page ID directly

page_id = uploader.upload_markdown_file(
filepath="path/to/your/document.md",
parent_page_id="16132a37-09e4-816c-b512-e4d73d345003"
)


## 🛠 可用的MCP工具

当用作MCP服务器时,可以使用以下工具:

### `upload_markdown`

将Markdown文件上传到Notion:

- `filepath`:.md文件的路径(必需)
- `parent_url`:通知页面URL(例如。, `https://notion.so/page-title-abc123...`)
- `database_id`:目标数据库ID(替代parent_url)
- `parent_page_id`:父页面ID(替代Parent_url)

### `upload_markdown_content`

直接上传Markdown内容:

- `content`:您的降价内容为文本(必填)
- `title`:页面标题(必填)
- `parent_url`:通知页面URL(推荐)
- `database_id` 或 `parent_page_id`:替代目标规范

### `list_database_pages`

列出数据库中的现有页面以供参考。

### `get_database_info`

获取有关特定数据库的信息。

## 💬 提示执行示例

MCP如果服务器设置成功,请在以下提示下Markdown打开文件Notion中所述修改相应参数的值。

### CLINE(VS Code扩展)示例```text
このMarkdownファイルをNotionにアップロードしてください:
/Users/username/Documents/my-notes.md

親ページURLはこちらです:
https://www.notion.so/16132a3709e4816cb512e4d73d345003

CLINE自动upload_markdown调用该工具并显示以下结果:```text
Successfully uploaded 'my-notes.md' to Notion.
Page ID: 29932a37-09e4-819d-a790-e8c025f28af5
View at: https://www.notion.so/29932a3709e4819da790e8c025f28af5


### Claude Code(Claude Desktop)使用示例```text
以下のMarkdownコンテンツを「週報 2024年10月」というタイトルでNotionページに変換してください:

# 今週の進捗
- プロジェクトAの設計完了
- バグ修正3件対応

## 来週の予定
- 実装開始
- コードレビュー

親ページ: https://www.notion.so/work-reports-abc123def456

Claude Code的upload_markdown_content使用工具做出以下响应:```text
Successfully uploaded content as '週報 2024年10月' to Notion.
Page ID: 12345678-90ab-cdef-1234-567890abcdef
View at: https://www.notion.so/12345678090abcdef1234567890abcdef


### 数据库指定中的使用示例```text
この研究ノートをNotionのデータベースにアップロードしてください:
- ファイル: /Users/username/research/ml-paper-summary.md
- データベースID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
- タイトルはファイル名を使用

多文件批量上载示例```text

以下のMarkdownファイルをすべて同じ親ページにアップロードしてください:
1. /path/to/chapter1.md
2. /path/to/chapter2.md
3. /path/to/chapter3.md

親ページ: https://www.notion.so/book-draft-xyz789


**注意**: MCP如果服务器未连接CLINE自动的Python回退到直接执行脚本。

## 📖 示例

直接上传Markdown内容:

- `content`:您的降价内容为文本(必填)
- `title`:页面标题(必填)
- `parent_url`:通知页面URL(推荐)
- `database_id` 或 `parent_page_id`:替代目标规范

**注意**: MCP如果服务器未连接CLINE自动的Python回退到直接执行脚本。

## 📝 支持的Markdown元素

- **标头** (H1-H6)→ 概念标题块
- **段落** → 概念段落块
- **列表** (项目符号和编号)→ 概念列表块
- **代码块** → 概念代码块
- **内联代码** → Notion内联代码
- **粗体和斜体文本** → 富文本格式概念
- **链接** → 概念链接

## 🔄 大文件处理

具有100个以上块的文件将自动处理:

1. 前100个块创建初始页面
1. 剩余的块会自动以块的形式附加
1. 结果:一个完整的Notion页面,包含所有内容

## 📋 需求

- Python 3.8+
- 概念客户端
- fastmcp
- python dotenv
- mistune(用于Markdown解析)

## 🗂 项目结构```bash
markdown2notion/
├── src/
│   ├── server.py           # MCP server implementation
│   ├── notion_uploader.py  # Core Notion API client
│   ├── markdown_processor.py # Markdown to Notion blocks converter
│   └── __init__.py
├── docs/
│   ├── design.md          # Architecture documentation
│   └── api/               # Detailed API docs
├── tests/
│   ├── test_notion_uploader.py
│   ├── test_markdown_processor.py
│   └── test_server.py
├── .env.example          # Environment template
├── pyproject.toml        # Project configuration
└── README.md            # This file

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
markdown2notion 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

markdown2notion 怎么在 Claude Desktop、Claude、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

markdown2notion 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

markdown2notion 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

markdown2notion 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cline、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

markdown2notion 能提供哪些能力?

资料显示能力标签包括 Markdown转换、开发工具、Python、Claude、文档处理。具体工具清单以官方文档为准。

markdown2notion 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

markdown2notion 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。