notion-export-mcp-server

notion-export-mcp-server

site icon
2025.04.09 0
TypeScriptNotion 导出工具MCP 服务交流协作
notion-export-mcp-server 是一个基于 MCP(Model Context Protocol)的服务,用于通过非官方 API 访问 Notion 并导出页面内容。该服务提供了一个标准化的接口,允许 AI 助手与 Notion 导出的页面数据进行交互。
View on GitHub

Overview

基本能力

产品定位

notion-export-mcp-server 是一个用于从 Notion 导出页面内容的工具,通过 MCP 协议提供标准化的接口。

核心功能

  • 通过非官方 API 访问 Notion 并导出页面内容。
  • 提供 notion_export_get_result 工具,用于获取 Notion 导出结果的 Markdown 文本。

适用场景

  • AI 助手需要与 Notion 导出的页面数据进行交互的场景。
  • 需要自动化导出 Notion 页面内容的场景。

工具列表

  • notion_export_get_result:获取 Notion 导出结果的 Markdown 文本。

常见问题解答

  • 如何获取 Notion 的 token_v2 和 file_token?
  • 登录 notion.so。
  • 打开浏览器的开发者工具,进入 Application > Storage > Cookies(Chrome)或 Storage 标签(Firefox)。
  • 复制 token_v2file_token 的值。
  • 如果找不到 file_token,需要至少手动导出一次文件。

  • 稳定性问题 该工具完全依赖于 Notion 官方但内部的 API,虽然下载功能相对稳定,但仍可能随时中断。

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。

安装教程

npm install notion-export-mcp-server

配置

需要设置以下环境变量: - NOTION_TOKEN_V2:您的 Notion token。 - NOTION_FILE_TOKEN:您的 Notion file token。

启动 MCP 服务器

直接运行:

npx notion-export-mcp-server

或者在 MCP 配置文件中添加以下内容:

"notion-export": {
  "command": "npx",
  "args": [
    "-y",
    "notion-export-mcp-server"
  ],
  "env": {
    "NOTION_TOKEN_V2": "<your token>",
    "NOTION_FILE_TOKEN": "<your token>"
  }
}

调试方式

  • 开发模式下启动服务器:
npm run dev
  • 运行示例脚本:
npm run examples

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。