🚀 notion-export-mcp-server

一个基于MCP（模型上下文协议）的服务器，通过访问Notion的非官方API来导出页面。此服务器提供与MCP兼容的接口，允许AI助手通过标准化界面交互您的Notion导出页面数据。

🚀 快速开始

📦 安装指南

手动安装

npm install notion-export-mcp-server

配置

• NOTION_TOKEN_V2：您的Notion令牌
• NOTION_FILE_TOKEN：您的Notion文件令牌

使用方法

启动MCP服务器

直接运行：

npx notion-export-mcp-server

或使用已安装的模块启动。

修改客户端的MCP配置json：

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

✨ 主要特性

可用工具：

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

🔑 密钥相关

如何获取

要从Notion导出任何内容，需要使用与已登录用户相同的认证。这些认证称为token_v2和file_token。它们是通过浏览器访问Notion时设置的Cookie。

1. 打开notion.so。
2. 使用您的账户登录。
3. 打开浏览器的开发者工具，前往应用 > 存储 > Cookie（Chrome）或存储选项卡（Firefox）。
4. 复制名为token_v2和file_token的Cookie值，并将它们保存到安全的地方。

   ⚠️ 重要提示

   如果未找到file_token，请确保至少手动导出过一次文件。

5. 这些Cookie的有效期为一年，因此无需频繁更新。

注意稳定性

此工具完全依赖于Notion.so的非公开但内部导出功能。优点是，我们不需要自动生成任何标记，只需下载并提取一些ZIP文件即可。尽管导出功能相对稳定，但它仍然是一个内部API，可能会随时更改或失效。

👨‍💻 开发相关

可用脚本

• npm run dev - 以开发模式启动服务器，并启用热重载
• npm run build - 构建项目以用于生产
• npm run start - 启动生产服务器
• npm run lint - 运行代码检查（ESLint 和 Prettier）
• npm run fix - 自动修复代码检查问题
• npm run examples - 运行示例脚本

贡献指南

1. Fork 仓库
2. 创建功能分支
3. 运行测试和代码检查：npm run lint
4. 提交更改
5. 推送到分支
6. 创建Pull Request